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머 리 말 


위대한 령도자 김정일동지께서는 다음과 같이 지적하시였다. 

《프로그람들 개발하는데서 기본은 우리 식의 프로그람들 개발하는것입니다. 우리는 우리 
식의 프로그람을 개발하는 방향으로 나가야 합니다.》 ( 《김정 일선집》제 15권，196폐지) 

위대한 령도자 김정 일동지의 현명한 령도에 의하여 오늘 우리 나라에서는 프로그람 
기술이 빠른 속도로 발전하고있다. 우리의 과학자，연구사들은 우리 식 조작체계 《붉은 
별》을 개발하였으며 각종 도구들과 응용프로그람들을 개발하기 위한 연구사업을 활발히 
진행하고있 다. 

우리는 정보공학을 전공하는 교원， 연구사들과 대학생들이 프로그람개발도구인 
Qt 에 의하여 프로그람을 능숙하게 작성할수 있도록 하기 위하여 《Qt 일반지식》과 
《Qt 프로그람개발법》, 《Qt 프로그람개발도구》， 《Qt 실례프로그람》을 출판한다. 

《 Qt 일 반지 식》에 서 는 Qt 의 객 체 모형 , 신호-처 리 부，사건과 사건려 과기 를 비 롯한 
Qt 프로그람이 기초하고있는 일반적인 지식을 서술한다. 

《 Qt 프로그람개 발법》에 서 는 Qt 에 의 한 GUI 프로그람작성 방법 을 서 술한다. 

《Qt 프로그람개 발도구》에서는 Qt Designer 를 비롯한 어에 부속되 여 있는 각종 도 
구들의 사용법 을 서술한다. 

《Qt 실례 프로그람》에서는 Qt 로 작성 한 실례 프로그람들을 서술한다. 

이 책들은 독자들이 표준 C++ 언어에 대한 지식을 소유하고있는것을 전제로 한다. 

우리는 Qt 의 일반지식과 프로그람작성법을 습득하고 우리 식의 조작체계에서 실행 
할수 있는 프로그람들을 더 많이 개 발함으로써 나라의 프로그람기 술을 한계단 더 발전시 
키고 인민경제의 정보화를 실현하는데 적극 이바지하여야 한다. 
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제 1 장. Qt 에 대한 소개 

어는 Trolltech 에 의하여 개발관리되는 다중가동환경 C ++ GUI 응용프로그람개발 
도구이 다. Qt 는 예술적조화를 갖춘 GUI 작성에 필요한 모든 기능을 프로그람개발자들에 
게 제공한다. Qt 는 완전히 객체지향적이고 확장하기 쉽고 진실한 를포넨트프로그람작 
성 을 가능하게 한다. 

Qt 는 1996년초에 상업적 인 소개 가 있은 다음에 세계적범위 에서 수천개의 성공적 인 
응용프로그람들의 기 초를 형 성하였 다. 또한 Qt 는 대 중적 인 KDE Linux 탁상환경 의 기 
초이며 Linux 의 모든 주요배포물들의 표준구성요소이 다. 

Qt 는 다음과 같은 가동환경 에서 동작한다. 

• MS/Windows - 95，98 ， NT 4.0， ME , 2000과 XP 

• Unix/Xll - Linux , Sun Solaris , HP - UX , Compaq Tru 64 UNIX , IBM 
AIX , SGI IRIX 등 

• Macintosh - Mac OS X 

• 매 몰형 - 틀완충기 가 유지 되 여있는 Linux 가동환경 . 

Qt 는 여 러 가지 판으로 출하된다. 

• Qt Enterprise 판과 Qt Professional 판은 상업용쏘프트웨어개발용으로 제공된다. 
이것들은 상업용쏘프트웨어배포물이며 무료로 갱신 및 기술지원봉사를 포함한다. 
Enterprise 판은 Professional 판에 비 하여 추가적 인 모둘들을 제공한다. 

• Qt 공개원천판은 Unix / Xll , Macintosh 와 매몰형 Linux 용이다. 공개원천판은 
오직 무료 및 공개원천쏘프트웨어개발용이다. 이것은 QPL(Q Public License ) 과 
GPL (GNU General Public License ) 에 서 무료로 구입 할수 있 다. 

제 1 절. Qt 상업판 

Qt Professional 과 Enterprise 판은 Qt 의 상업판이 다. 

Professional 판이 나 Enterprise 판을 구입 할수 있다면 상업 권과 소유권，비 공개 쏘 
프트웨어 를 작성 할수 있 다. (인정된 공개 원천허 가를 리 용하여 출하하기 위 한 무료 및 
공개 원천쏘프트웨어 를 개 발하려 면 Qt 공개 원천판을 사용할수 있 다. ) Qt 상업 판의 구입 은 
기술적지원과 갱신을 포함한다. Microsoft Windows 용 Qt 는 Professional 과 
Enterprise 판에서만 사용할수 있다. 


표 1-1. Professional 과 Enterprise 의 비교 


Professional/Enterprise 비 교표 

Professional 

Enterprise 

Qt 기초모둘(도구，핵심，창문부품，대화칸) 

가동환경에 의존하지 않는 Qt GUI 도구와 편의콜라 
스들 

X 

X 

Qt Designer 

Visual Qt GUI 구축프로그람 

X 

X 

그림 기 호보기 모둘 

사용자교제 기 능이 있는 픽 스매 프모임 의 시 각화 

X 

X 

작업공간모둘 
다중문서대면부유지 

X 

X 

OpenGL 3차원도형처리모둘 

Qt 와 OpenGL 의 통합 


X 




Professional/Enterprise 비 교표 

Professional 

Enterprise 

망 모둘 

소케트와 TCP , FTP , 비동기 DNS 조사용의 가동환 
경에 의존하지 않는 들라스들 


X 

캔버스모둘 

시각화，도표 등을 위한 최적화된 2차원도형처리령 
역 


X 

표모듈 

유연하고 편집가능한 표/표계산프로그람 


X 

XML 모둘 

SAX 대면부와 DOM 준위1을 갖춘 잘 형성된 XML 
구문해 석 기 


X 

ActiveQt 확장 

Windows 에서 ActiveX 조종요소구축 및 주콤퓨터 
화를 지원 


X 

QMotif 확장 

Motif 호상존재와 이식의 지원 


X 


제 2 절. Qt 공개원천판 

공개원천쏘프트웨어(일명 무료쏘프트웨어)는 사용자들에게 일정한 권한을 주는 사 
용허가를 가진 쏘프트웨어이다. 특히 쏘프트웨어를 사용할 권한, 원천을 수정할 권한， 
원천을 엄을 권한，그것을 넘길 권한(같은 조항하에서)을 준다. 

Trolltech 는 Qt 공개원천판을 제공하여 공개원천쏘프트웨어개념을 지원한다. 어의 
이 판을 사용하여 공개원천쏘프트웨어 즉 GNU GPL 하에서 허가되거나 류사한 공개원 
천허 가하에 있는 쏘프트웨어 를 창조할수 있 다. Qt 공개 원천판으로 Trolltech 공개 원천지 
원은 KDE 와 같은 큰 규모의 성공적인 쏘프트웨어프로젝트를 창조하고 세계의 수천명의 
개발자들이 무상으로 Qt 공개원천판을 사용할수 있게 한다. Qt 공개원천판은 Unix / Xll , 
마킨토쉬 와 매 몰형리 눅스에서 사용할수 있 다. 

Qt 를 사용하여 상업쏘프트웨어개발도 가능하며 그러자면 Professional 혹은 
Enterprise 판에 대한 상업허가를 구입해야 한다. Qt 상업판을 산다면 자기가 좋아하는 
가격과 사용허가에 맞게 자기의 쏘프트웨어를 팔수 있다. 수천개의 상업회사들은 Qt 상 
업판을 사용하여 자기들이 팔 제품을 개발한다. 

Qt 공개 원천판을 사용하면 GNU GPL 이 부여하는 일정한 허 가조건이 있어 GPL 에 
의해 담보되는 권한을 사용자들이 줄기도록 담보한다. 사용자들에게는 다음과 같은 권한 
이 부여된다. 

① 자기의 쏘프트웨어를 임의의 목적으로 실행한다. 

② 자기 쏘 프트웨 어의 원천코드를 엄 어 학습하며 이것을 자기의 목적 에 맞게 적응 
시킨 다. 

③ 자기 쏘프트웨어 와 그 원천코드를 다른곳에 (같은 조항하에 서 ) 재 배 포한다. 

④ 자기 쏘 프트웨 어 를 개 선하거 나 수정하며 이 갱 신품을 공개 출하한다. 

이 권리는 누구에 의 해 씌 여졌는가에 관계 없이 자기 쏘프트웨어 가 기 초하고있는 모 
든 모둘에 한해서 모든 원천코드에 적용된다. 또한 이 권리는 임의의 련관된 대면부정의 
파일들에 적용되며 지 어는 실행파일의 틈파일과 설치 를 조종하는데 쓰이는 스크립트와 




조종파일들도 포함한다. 그렇지 않으면 사용자들은 자기의 권리를 실현할수 없다. 

이것은 자기의 쏘프트웨어가 쏘프트웨어특허，상업적허 가동의，저작권이 있는 대면 
부정의 혹은 임의의 부류의 공개되지 않은 동의를 비롯하여(하지만 여기에 제한되지 않 
는다) GNU GPL 의 조항들에 모순되는 조건들을 강요하는 모둘로 구축되여야 한다면 
Qt 공개원천판을 사용할수 없다는것을 의미한다. 이 러한 조건에서는 Qt 상업판을 리용해 
야 한다. ( Qt 공개원천판허가와 그와 관련된 질문에 대한 대답은 부록1을 참고하시오.) 


제3절. 어의 간단한 력사 

Qt 도구묶음은 1995년 5월에 처음으로 공개되였다. Qt 는 초기에 하바드 노드 
( Trolltech 의 CEO ) 와 에 이 리 크 캄베 앵 ( Trolltech 의 사장) 에 의 해 개 발되 였 다. 

C ++ GUI 개발에 대한 하바드의 관심은 Swedish 회사로부터 C ++ GUI 도구묶음을 
설계 하고 실현할데 대 한 위 임을 받은 1988년에 시 작되 였다. 2년이 지난 1990년 여름 
하바드와 에 이리크는 Unix 와 Macintosh , Windows 의 GUI 에서 실행해 야 하는 초음파 
화상용의 C ++ 자료기지 응용프로그람에 대 하여 함께 연구하고있었 다. 그들은 객체지 향형 
의 체계가 필요하다고 결론하고 객체지향형 여러가동환경 GUI 도구묶음을 위한 지능적 
인 기초를 쌓고 그것을 곧 구축하기 로 하였다. 

1991년에 하바드는 현재 Qt 로 된 클라스들을 에 이리크와 협동하여 쓰기 시 작하였 
다. 다음 해 에 에 이리크는 간단하면서도 강력한 GUI 프로그람작성원형 인 《 신호와 처 리 
부》라는 개념을 내놓았다. 하바드는 그 개념에 동감하고 코드의 실현을 계속하였다. 
1993년에 하바드와 에 이리크는 Qt 의 첫 그라픽스핵심을 개 발하고 자체의 창문부품들을 
실현하였다. 그해 말에 하바드는《세계에서 가장 좋은 C ++ GUI 도구묶음》을 구축하기 
위한 사업 을 시 작할것 을 제 안하였 다. 

그들은 하바드의 Emacs 서체에서 Q 가 아름답다고 보고 클라스의 앞붙이로 선택하 
였다. t 는 X Toolkit 에서 Xt 에서와 같이 toolkit 라는 의미에서 추가하였다. 회사는 
1994년 3월 4일에 처음에 Quasar Technologies 주식회사로 되였으며 그다음 Troll 
Tech , 오늘은 Trolltech 로 되였다. 

1995년 4월에 하바드종합대학의 한 교수를 통하여 접촉이 이루어져 노르웨이회사 
Metis 가 그들에 게 Qt 에 기 초하여 쏘프트웨어 를 개 발할 계 약을 하였 다. 이 때 Trolltech 
는 안트 굴브랜드센을 고용하였다. 그는 Qt 의 코드에 기 여하는것은 물론 훌륭한 문서체 
계를 실현하였다. 

1995년 5월 20일에 Qt 0.90 을 sunsite . unc . edu 에 적재 하였다. 6일후에 출하판 
이 comp . os . linux . announce 에 발표되였다. 이것은 Qt 의 처음으로 되는 공개출하판 
이 다. 어는 Windows 와 Unix 개발에 사용할수 있으며 두 가동환경에서 같은 API 를 제 
공한다. Qt 는 두가지 사용허가하에서 사용할수 있다. 상업허가는 상업적 인 개발에 요구 
되 며 무료쏘프트웨 어 판 (free software edition ) 은 공개 쏘프트웨 어 개 발에 필요하다. 
Metis 계약은 Trolltech 가 크게 활약하게 하였고 10개월이상 누구도 상업용의 Qt 허가 
를 구입하지 않았다. 

1996년 3월에 유럽우주기구 (European Space Agency ) 는 이의 두번째 손님으로 
되 였으며 10개의 상업허가권을 구입하였다. 확신을 가지고 에 이리크와 하바드는 다른 
개발자를 고용하였다. Qt 0.97 은 5월말에 출하되였으며 1996년 9월 24일 Qt 1.0 이 나 
왔다. 그해 말에 Qt 는 1.1 판에 이르고 여러 나라의 8명의 손님이 18개의 허가권을 구 
입 하였 다. 그해 에 또한 마리 아스 에 트리치 가 지 도하는 KDE 설 계 의 기 초가 구축되 였 다. 

Qt 1.2 는 1997년 4월 에 출하되 였 다. 마리 아스 에 트리치 에 의하여 Qt 를 리 용하여 
KDE 를 구축할데 대 한 론의 는 Linux 에서 C ++ GUI 개 발을 위 한 실제 상의 표준으로 되 



였다. Qt 1.3 은 1997년 9월에 출하되였다. 

마리아스는 1998년에 Trolltech 에 합류하였으며 Qt 1의 마지막 판 1.40 이 그해 
9월에 개발되였다. Qt 2.0 은 1999년 6월에 출하되였다. Qt 2는 주요한 구조변경을 하 
였으며 이전보다 훨씬 더 강력하고 성숙되였다. 또한 40개의 새 콜라스와 유니코드를 
추가하였다. Qt 2는 새로운 공개원천사용허가 즉 Q 공개허가 (Q Public License , 
QPL ) 를 가지게 되였으며 이것은 공개원천정의에 따라 름파일된다. 1999년 8월 이는 
Linux 세계에서 가장 좋은 서고， 도구로 인정되였다. 그 무렵에 Trolltech Pty Ltd 
(오 스트랄 리 아)가 수립되였다. 

2000년에 Trolltech 는 Qt / Embedded 를 출하하였다. 이것은 매몰형 Linux 장치들 
에서 실행하도록 설계되였으며 자체의 창문체계를 제공함으로써 XII 의 간단한 교체를 
가능하게 한것이다. Qt / Embedded 와 Qt / Xll 은 둘다 상업허가하에서는 물론 널리 리 
용된 GNU GPL (General Public License ) 하에 서 현재 제 공되 였 다. 2000년 말 
Trolltech 는 Trolltech Inc 회사를 세우고 주머니 형름퓨터의 환경인 Qtopia 의 초판을 
출하하였다. Qt / Embedded 는 20()1 년과 2002년에 Linux 세계에서 《가장 좋은 매몰형 
Linux 제 품》으로 알려 졌 다. 

Qt 3.0 은 20()1 년에 출하되였다. 현재 어는 Windows 와 Unix , Linux , 
Embedded Linux , Mac OS 표에서 사용할수 있게 되였다. Qt 3.0 은 42개의 새 들라 
스들과 50만행이상의 코드를 제공하였다. Qt 3.0 은 2002년에 쏘프트웨어개발상 《Jolt 
Productivity Award 》 를 받았다. 

Trolltech 의 판매는 회사의 출현후 해마다 배로 늘어났다. 이 러한 성과는 어의 질 
과 그것을 얼마나 즐기고 있는가에 대한 반영이다. 회사의 존재，판매，시장의 대부분은 
두 사람에 의해 조종된다. 10년이 되기전에 Qt 는 《신비한》제품으로 되였고 선발된 
전문가그룹으로 알려 져 있으며 수천명 의 손님 과 수만명 의 공개 원천개 발자들을 세 계 각지 
에 가지고있다. 



제 2 장. Qt 의 시작 


제1절. Qt 학습방법 

이 책에서는 독자들이 이미 C ++ 를 알고있는것을 전제로 한다. 

Qt 를 배우는 가장 좋은 방법은 《 Qt 프로그람개발법》을 읽는것이다. 이 책은 
"Hello Qt ” 로부터 시작하여 다중스레드프로그람작성，2차원과 3차원 도형 처 리，망프로 
그람작성 , 그리 고 XML 과 같은 고급한 특성 에 이 르기 까지 포괄적 인 Qt 프로그람작성방 
법을 제 공한다. 

그렇지 않으면 이 책에서 제안하는 학습프로그람을 읽는다. 설계도구없이 자기 대 
면부를 코드로 설계하는 순수 C ++ 프로그람을 작성하려 고 한다면 2절과 3절을 읽는다. 2 
절 은 코드를 강조하면서 Qt 프로그람작성 법 에 대 하여 설 명하였 다. 3절 은 차림 표, 도구띠 , 
파일적재 와 보존，대 화칸 등의 코드작성 법 을 보여 주는 더 실천적 인 실례 들을 제시한다. 

설계 도구를 사용하여 사용자대 면부를 설계하려 고 한다면 《 Qt 프로그람개 발도구》1 
장의 처음 몇개 절을 읽는다. 그다음 2절과 3절을 실행하여본다. 

그러면 Qt 로 작은 작업프로그람을 생성하고 프로그람작성법에 대한 폭넓은 지식을 
얻을수 있다. 자체 로 프로젝트에 대 한 작업을 직접 시 작할수 있지만 Qt 를 더 깊이 리해 
하기 위 하여 3장의 1절，3절 (Qt 객 체 모형 과 신호와 처 리 부)을 읽 는다. 

이 시점에서 4장에서 자기 프로젝트와 관련한것들을 읽을것을 권고한다. 또한 자기 
프로젝트와 공통성을 가지는 실례들의 원천코드를 보는것이 좋다. 또한 Qt 의 원천코드 
를 읽을수 있다. 

$QTDIR/examples/demo 에 있는 demo 프로그람을 실행한다면 동작하는 Qt 창문부품들 
을 많이 볼수 있다. 

Qt 는 포괄적인 문서를 제공하며 그것은 초본문 교차참고형식을 가지므로 요구하는 
것을 선택하여 볼수 있다. 사용자가 리용하는 문서부분은 아마 API 참고일것 이 다. 각 련 
결은 API Reference 를 항행하는 각이한 방법을 제공한다. 또한 Qt Assistant 도구는 
Qt 에 제공되는데 모든 Qt API 에 대 한 호출을 제공하며 완전본문람색편의를 제공한다. 


제2절. 포쏘기유회의 작성 

이 절에서는 Qt 개 발도구를 사용한 GUI 프로그람작성 법 을 소개한다. 

처음에 10행의 hello-world 로 시작하여 여러가지 개념들을 소개 하며 마지막에는 
650행의 유희로 전환된다. 

여기서 소개하는 작은 유희는 현대적인 GUI 응용프로그람은 아니고 다만 몇가지 
GUI 수법을 리용할뿐이다. 3절에서는 좀 더 형식적이고 차림표띠, 도구띠，적재와 보관, 
대화칸와 같은 응용프로그람의 전형적인 기능들을 설명한다. 

1. Hello, World! 프로그람 

첫 프로그람은 간단한 hello-world 실례이다. 여기에는 Qt 응용프로그람을 작성하고 
실행하는데 필요한 최소의 골격 이 들어 있다. 그림 2-1 은 이 프로그람의 실행화면이 다. 


그림 2-1. Hello , World ! 프로그람 





finclude < qapplication . h > 

#include < qpushbu 竹 on . h > 

int main ( int argc , char **argv ) 

t 

QApplication a ( argc , argv ) : 

QPushButton hello ( "Hello world !", 0 )； 
hello , resize ( 100, 30 ); 

a.setMainWidget( &hello); 

hello.show(); 

return a.exec(); 

} 

(1) 명령문설명 

#include < qapplication . h > 

이 행은 QApplication 클라스정의를 포함한다. Qt 를 사용하는 모든 응용프로그람 
에는 정확히 하나의 QApplication 객체가 있어야 한다. QApplication 은 기정서체，유 
표와 갈은 응용프로그람의 각종 자원을 관리한다. 

#include < qpushbutton . h > 

이 행은 QPushButton 쿨라스정의를 포함한다. 각 콜라스에 대한 머리부파일을 
콜라스를 사용하는 파일의 선두에 서술한다. 

QPushBu 竹 on 은 사용자가 눌렀다 놓을수 있는 전형적인 GUI 누름단추이다. 이것 
은 다른 모든 QWidget 처럼 그 자체의 형식을 관리한다. 창문부품은 사용자입력을 처리 
하고 도형 을 그릴수 있는 사용자대 면부이다. 프로그람작성 자는 창문부품의 내 용은 물론 
색과 같은 그의 총체적인 형식 그리고 많은 속성들을 변경할수 있다. QPushButton 은 
본문이 나 QPixmap 를 표시 할수 있 다. 

int main ( int argc , char **argv ) 

l . 

mainO 함수는 프로그람의 입구점이다. Qt 를 사용할 때 항상 mainO 은 Qt 서고에 
조종을 넘기여 프로그람이 사건을 통하여 사용자의 동작에 대하여 알리기전에 몇가지 초 
기화를 수행해 야 한다. 

argc 는 지령행인수의 개수이고 argv 는 지령행인수의 배렬이다. 이것은 C 八:++의 
특성으로서 Qt 에 고유하지 앉지만 Qt 는 이 인수들을 처리해야 한다. 

QApplication a ( argc , argv ) : 

a 는 이 프로그람의 QApplication 객체이다. 여기서는 X Window 에서 - display 와 
같은 몇가지 지령행인수를 생성하고 처리한다. Qt 가 인식한 모든 지령행인수는 argv 에 
서 삭제 되 므로 argc 는 감소된 다 ( QApplication :: argv () 참고) . 

알아두기: QApplication 객체는 Qt 의 창문부분품을 사용하기전에 생성되여야 한다. 

QPushButton hello ( "Hello world !", 0 )； 

여기서 QApplication 뒤에 처음의 창문체계코드가 오며 하나의 누름단추가 생성된다. 
본문 "Hello world !" 를 표시하기 위하여 단추를 설치하며 그 자체는 창문이다. 
구성 자가 부모창문으로서 0을 지정하므로 단추는 그 안에 배 치되 여 야 한다. 
hello , resize ( 100，30 ); 

단추는 100화소폭과 30화소높이로 설정된다. 여기에 창문의 틀이 첨부된다. 이 경 
우에 단추의 위치를 설정하지 않으면 기정값을 받아들인다. 
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a . setMainWidget ( Shello ); 

누름단추는 응용프로그람의 기본창문부품으로서 선택된다. 사용자가 기본창문부품 
을 닫으면 응용프로그람은 완료한다. 

기본창문부품은 없지만 대부분의 프로그람은 그것을 가전다. 
hello . showO : 

창문부품은 그것을 창조한 다음 showO 를 호출하여 표시한다. 
return a . exec () : 

} 

여기서 main () 은 Qt 에로 조종을 넘기며 exec () 는 응용프로그람이 완료할 때 되 
돌아간다. 

execO 에서 어는 사용자와 체계의 사건들을 받아들이고 처리하며 이것들을 적당한 
창문부품에 넘긴다. 

이제는 프로그람을 를파일하고 실행할수 있다. 

( 2 ) 콤파일 

C ++ 응용프로그람을 틈파일하려면 makefile 을 생성하여야 한다. Qt 용의 makefile 
을 생성 하는 가장 간단한 방법은 Qt 에 제공되는 qmake 구축도구를 사용하는것 이 다. 자 
기 등록부에 main . cpp 를 보관하였 다면 다음과 같이 실 행 한다. 

qmake -project 

qmake 

첫째 지령은 qmake 가 . pro (프로젝트)파일을 만들게 한다. 둘째 지령은 프로젝트파 
일에 기초하여 가동환경에 고유한 makefile 을 생성한다. 이제는 make (Visual Studio 를 
사용한다면 nmake ) 라고 입 력 하고 처 음의 Qt 응용프로그람을 실 행한다. 

(3) 동작 

프로그람을 실행하면 하나의 단추로 꽉찬 하나의 자그마한 창문을 보게 된다. 창문 
에서 단어 Hello World ! 를 읽을수 있다. 

(4) 련습 

창문의 크기를 조절해보시오. 단추를 눌러보시오. X Window 에서 실행한다면 - 
geometry 선택 (례 를 들면 - geom 的 7 100x200 + 10 + 20 ) 으로 프로그람을 실행 하시 오. 

2. Quit 호출 

소절 1 에서 창문을 창조하였으므로 사용자에 의해 응용프로그람을 적당히 완료할수 
있 다. 

또한 기정보다 더 좋은 서체를 사용할수 있다. 

-B x| 

Quit || 


그림 2-2. Quit 호출 


#include < qapplication . h > 
#include < qpushbutton . h > 
#include < qfont . h > 

int main ( int argc , char **argv ) 

{ 

QApplica 仕 on a ( argc , argv ) ； 
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QPushButton quit ( " Quit ", 0 ); 
quit , resize ( 75, 30 ); 

quit . setFont ( QFont ( " Times ", 18, QFont： : Bold ) ); 


QObject： : connect ( &quit, SIGNAL (clicked ()), 技 a, SLOT (quit ()) )： ；： 

a. setMainWidget ( &quit )； 
quit, show 0 : 
return a. exec 0; 

} 

( 1 ) 명령문설명 
#include <qfont. h> 

프로그람이 QFont 를 사용하므로 qfont.h 를 포함하여야 한다. Qt 의 서체 추상화는 
표에서 제공하는것과 다르고 서체의 적재와 사용은 고도로 최적화된다. 

QPushButton quit( "Quit", 0 ); 

단추는 Quit 를 통보하는데 그것은 사용자가 단추를 눌렀다 놓을 때 프로그람이 수행 
하는 동작이 다. 여전히 부모창문으로서 0을 넘기므로 단추는 제 일웃준위창문으로 된다. 
quit, resize( 75, 30 ); 

본문이 "Hello world!" 보다 짧으므로 단추의 크기를 다르게 선택한다. 또한 
QFontMetrics 를 사용하여 정확한 크기로 설정한다. 

quit.setFont( QFont( "Times", 18, QFont： : Bold ) ); 

여기서는 Times 계렬로부터 18point 강조서체를 단추의 새로운 서체로 선택한다. 즉 
시 서체를 생성하는것은 아니다. 

또한 QApplication :: setFont() 를 사용하여 전체 응용프로그람에 대 하여 기정서체 를 변경 할 
수있다. 

QObject ： ： connect ( &quit, SIGNAL (clicked ()), &a, SLOT (quit ()) ); 
connectO 는 Qt 의 가장 주요한 특성이다. connected QObject 에서 정적함수이 
다. 이 함수를 소케트서고의 connectO 함수와 삭갈리지 말아야 한다. 

이 행 은 2 개 의 Qt 객 체(직 접 적 으로나 간접 적 으로 QObject 를 계 승하는 객 체 )들사이 
에 한통로련결 을 확립한다. 매 개 Qt 객 체 는 (통보를 보내 기 위한) 2 개 의 신호와 (통보를 
받기 위한) 처리부를 가전다. 모든 창문부품은 Qt 객체이다. 창문부품들은 QObject 를 
계승하는 QWidget 로부터 파생된다. 

여기서 quit 의 clicked(9 신호는 a 의 quit(9 처리부에 련결되므로 단추를 눌렀다놓으면 응 
용프로그람은 완료한다. (3 장 3 절에서 자세 히 설명한다.) 

⑵ 동작 

이 프로그람을 실행하면 소절 1 에서보다 아주 작은 단추가 들어있는 창문을 볼수 

있 다. 

(3) 련습 

창문의 크기를 조절해보시오. 단추를 눌러보시오. connectO 는 좀 차이난다. 

Quit (중지)와 련결할수 있는 다른 신호가 QPushButton 에 있는가? 

( 암시 : QPushButton 은 QButton 으로부터 그의 대부분의 동작을 계승한다.) 

3. 가족값 

이 실례는 부모와 자식창문부품의 생성방법을 보여준다. 

간단히 하나의 부모와 하나의 자식을 사용한다. 
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그림 2-3 . 가족값 


#include < qapplication . h > 
#include < qpushbutton . h > 
#include < qfont . h > 
#include < qvbox . h > 


int main ( int argc , char **argv ) 

{ 

QApplication a ( argc , argv ) ； 


QVBox box ； 

box. resize( 200, 120 ) ； 

QPushButton quit( ” Quit", 技 box ) ； 

quit. setFont( QFont( "Times", 18, QFont： : Bold ) ); 

QObject： : connect ( &quit, SIGNAL (clicked ()), 技 a, SLOT (quitO) ) ； 


a . setMainWidget ( &box ) ； 
box . show (); 

return a.execO ； 

} 

(1) 명령문설명 
#include < qvbox . h > 

머 리부파일 qvbox . h 를 추가하여 사용하려는 배 치관리클라스를 엄는다. 

QVBox box ； 

여 기서는 단순히 수직칸용기를 창조한다. QVBox 는 수직행안에 그 자식창문부품 
들을 배 렬 한다. 이 때 매 개 자식 의 QWidget： : sizePolicy 0 에 따라 공간을 분배 한다. 
box . resize ( 200, 120 ) ； 

그 폭은 200화소，높이는 120화소로 설정한다. 

QPushButton quit ( " Quit ", &box ) ； 

하나의 자식을 만든다. 

본문 (’’ Quit ”) 과 부모 ( box ) 를 가지는 QPushButton 이 생성된다. 자식창문부품은 
늘 부모우에 놓이며 표시될 때 부모의 경계에 의하여 잘리운다. 

부모창문부품 QVBox 는 자동적으로 칸의 중심에 있는 자식에 추가된다. 아무것도 
추가되지 않으므로 단추는 부모가 가지고있는 모든 공간을 차지한다. 
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box . showO : 

부모창문부품이 표시될 때 그의 모든 자식들의 표시를 호출한다. (그러나 명시적인 
QWidget :: hide () 를 수행한것들은 제외된다.) 

(2) 동작 

단추는 더는 전체 창문부품을 차지하지 않는다. 실제로 자연적인 크기를 얻는다. 
이것은 단추크기의 암시와 크기변경방략을 사용하여 단추의 크기와 위치를 설정하는 새 
로운 웃준위 창문부품이 있기 때 문이 다. ( QWidget： : sizeHint () 와 

QWidget :: setSizePolicy 0 참고 .) 

(3) 련습 

창문의 크기를 변경해보시오. 단추가 어떻게 변하는가? 단추크기의 변경방략은 무엇인 
가? 더 큰 서 체 로 프로그람을 실행 하면 단추의 높이 에서 어떤 변화가 생 기는가? 실제 로 작은 
창문을 만들려 고 하면 어 떤 현상이 생 기 는가? 

4. 창문부품 

이 실례에서는 자체의 창문부품을 만드는 방법과 창문부품의 최소 및 최대크기를 
조종하는 방법을 서술하고 창문부품이름을 소개한다. 



그림 2-4. 창문부품 


ttinclude 〈 qapplica 仕 on . h > 

#include < qpushbutton . h > 
ttinclude < qfont . h > 

class MyWidget : public QWidget 

{ 

public ： 

MyWidget ( QWidget * parent =0, const char * name =0 ); 

}； 

MyWidget :: MyWidget ( QWidget * parent , const char *name ) 
: QWidget ( parent , name ) 

{ 

setMinimumSize ( 200, 120 ); 
setMaximumSize ( 200, 120 ); 


QPushButton *quit = new QPushButton ( " Quit ", this , " quit " ); 

quit -> setGeometry ( 62, 40, 75, 30 ); 

quit -> setFont ( QFont ( " Times ", 18, QFont： : Bold ) ); 
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connect ( quit , SIGNAL (clicked ()), qApp , SLOT (quit ()) ); 


int main ( int argc , char **argv ) 

{ 

QApplication a ( argc , argv ) : 

My Widget w ； 

w . setGeometry ( 100, 100, 200, 120 ); 
a . setMainWidget ( &w ); 
w . show (); 
return a . exec 0; 

} 

(1) 명령문설명 

class MyWidget : public QWidget 
1 

public ： 

MyWidget ( QWidget * parent =0, const char * name =0 ); 

}； 

여기서는 새로운 들라스를 만든다. 이 들라스는 QWidget 를 계승하는 창문부품이 
고 제 일 웃준위의 창문 또는 자식창문부품(제3절의 누름단추 등)일수도 있다. 

이 콜라스에는 오직 하나의 성원 즉 구성자(그밖에 QWidget 로부터 계승되는 성원 
들)가 있다. 구성자는 표준 Qt 창문부품구성자이고 창문부품들을 만들 때 항상 류사한 
구성 자를 포함해 야 한다. 

첫째 인수는 그 부모창문부품이다. 제일 웃준위의 창문을 만들려면 null 지적자를 부 
모로서 지정한다. 알고있겠지만 이 창문부품은 기정으로 제 일 웃준위의 창문으로 된다. 

둘째 인수는 창문부품이름이다. 이것은 창문의 제목띠나 단추에 표시되는 제목이 
아니며 이 창문부품을 식별하기 위한 이름이다. 

MyWidget ： : MyWidget ( QWidget * parent , const char *name ) : 

QWidget ( parent , name ) 

구성자의 실현은 여기서 시작된다. 대부분의 창문부품들처럼 구성자는 단지 부모와 
이름을 QWidget 구성자에 넘긴다. 

{ 

setMinimumSize ( 200, 120 ); 
setMaximumSize ( 200, 120 ); 

이 창문부품이 크기변경방략을 모르므로 최소 및 최대크기를 꼭같이 설정한다. 다 
음 소절 에서는 창문부품이 사용자로부터 의 크기변경사건에 대 응하는 방법 을 보여 준다. 
QPushButton *quit = new QPushButton ( " Quit ", this , " quit " 
quit -> setGeometry ( 62, 40, 75, 30 ); 
quit -> setFont ( QFont ( " Times ", 18, QFont： : Bold ) ); 

여기에는 이름 quit 를 가지는 자식창문부품(새 창문부품의 부모는 this 이다.)을 만 
들고 설정한다. 창문부품이 름은 단추본문과 관계 없고 이 경 우에 는 우연히 비숫해 졌 다. 

quit 는 구성자의 국부변수이다. MyWidget 는 그의 정보를 계속 엄지 못하지만 어에 의 
하여 My Widget 가 삭제 될때 기정 으로 quit 를 삭제 한다. 이것은 My Widget 가 해 체 자를 요구 
하지 않기때문이다. 
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setGeometryO 호출은 앞 절들에서 move 0와 resize 0가 수행하는것과 같은 일을 한다. 
connect ( quit , SIGNAL (clicked ()), qApp , SLOT (quit ()) ) ； 

} 

MyWidget 클라스는 응용프로그람객체를 잘 모르므로 그것에로의 Qt 지적자 qApp 와 
련결되여야 한다. 

창문부품은 쏘프트웨어구성요소이고 될수록 일반적이고 재사용할수 있도록 하기 위 
하여 그 환경을 알아야 한다. 

응용프로그람객체의 이름을 알고 있으면 이 원칙을 어기게 되므로 Qt 는 MyWidget 
와 같은 구성요소가 응용프로그람객체와 대화하는 경우를 위하여 가명 qApp 를 제공한다. 
int main ( int argc , char **argv ) 

{ 

QApplication a ( argc , argv ); 

MyWidget w ； 

w . setGeometry ( 100, 100, 200, 120 ) ； 
a . setMainWidget ( &w ) ； 
w.showO ； 
return a . exec 0 ； 

} 

여기서는 새로운 자식실례를 만들어 기본창문부품으로 설정하고 응용프로그람을 실 
행 한다. 

(2) 동작 

이 프로그람은 이전 프로그람의 동작과 아주 류사하지만 실현방법과 동작이 약간 
다르다. 그것을 보려면 크기를 변경하여야 한다. 

(3) 련습 

main () 에 또 하나의 MyWidget 객체를 만들어보시오. 어떤 일 이 일어나는가? 
단추를 더 많이 추가하거 나 QPushButton 이 외 의 창문부품들을 넣 으시 오. 

5. 블로크구축 

이 실례는 신호와 처리부를 사용하여 여러개의 창문부품을 만들고 모두 련결하는 
방법과 크기변경사건을 조종하는 방법을 보여준다. 



그림 2-5. 블로크구축 


#include 

#include 

#include 

#include 

#include 

■elude 


< qapplication . h > 
< qpushbutton . h > 
< qslider . h > 
< qlcdnumber . h > 
< qfont . h > 
< qvbox . h > 


class MyWidget : public QVBox 
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{ 

public ： 

My Widget ( QWidget * parent =0 ，const char * name =0 ) ； 


My Widget ： : My Widget ( QWidget * parent，const char *name ) 

: QVBox ( parent , name ) 

{ 

QPushButton *quit = new QPushButton ( ’’ Quit ’’， this , " quit " ) ； 
quit -> setFont ( QFont ( ’’ Times ”, 18， QFont： : Bold ) ) ； 

connect ( quit , SIGNAL (clicked 0)， qApp , SLOT (quit ()) ) ； 

QLCDNumber *lcd = new QLCDNumber ( 2， this , ’’ led ” ) ； 

QSlider * slider = new QSlider ( Horizontal , this , ’’ slider ” ) ； 
slider->setRange ( 0， 99 ) ； 
slider->setValue ( 0 ) ； 

connect ( slider , SIGNAL ( valueChanged ( int )), led , 

SLOT (display ( int )) ) ； 

} 


int main ( int arge , char **argv ) 

{ 

QApplication a ( arge , argv ) ； 

My Widget w ； 
a . set Main Widget ( &w ) ； 
w . showO ； 
return a . exec 0 ; 

} 

(1) 명령문설명 

#include < qapplication . h > 

#include < qpushbutton . h > 

#include < qslider . h > 

#include < qlcdnumber . h > 

#include < qfont . h > 

#include < qvbox . h > 

여기서 3 개의 새 머리부파일을 포함한다. qslider.h 와 qlcdnumber.h 는 2 개의 새 
로운 창문부품 QSlider 와 QLCDNumber 를 사용하기 위하여 포함하며 Qvbox.h 는 Qt 
의 자동배 치기능을 사용하기 위하여 포함한다. 
class MyWidget : public QVBox 
{ 

public ： 

MyWidget ( QWidget * parent =0, const char * name =0 ) ； 
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}; 

My Widget :: My Widget ( QWidget * parent , const char *name ) : 

QVBox ( parent , name ) 

{ 

현재 My Widget 는 QWidget 대신에 QVBox 에서 파생되며 QVBox 의 배치관리자를 
사용한다. (이 것 은 자식 들을 수직 으로 배 치한다. ) 또한 크기 변경 은 QVBox 에 의 해 즉 
MyWidget 에 의해 자동적으로 조종된다. 

QLCDNumber *lcd = new QLCDNumber ( 2, this , " led " ); 

led 는 QLCDNumber 토서 LCD 방식 으로 수를 표시하는 창문부품이 다. 이 실례 는 2 
자리를 표시하도록 this 의 자식으로 설정된다. 그것을 " led ” 라고 이름짓는다. 

QSlider * slider = new QSlider ( Horizontal , this , " slider " );■ 
slider -> setRange ( 0, 99 ); 
slider->setValue ( 0 ); 

QSlider 는 전형적인 미끄럼띠로서 사용자가 창문부품을 끌기하여 일정한 범위에서 
옹근수값을 조절할수 있다. 여기서는 수평미끄럼띠를 만들고 범위를 0-99 로 설정하며 
( QSlider ： isetRange 0문서 참고) 초기 값을 0으로 설정 한다. 

connect ( slider , SIGNAL (valueChanged ( int )), led , 

SLOT (display ( int )) ); 

여기서는 신호-처리부기구를 사용하여 미끄럼띠의 valueChanged 0신호를 LCD 수 
의 displayO 처리부에 련결한다. 

미끄럼띠의 값이 바뀔 때마다 valueChanged 0신호를 내보내여 새로운 값을 전송 
한다. 그 신호가 LCD 수의 displayO 처 리부에 련결되 여있으므로 처 리부는 신호가 전송 
될 때 호출된다. 어느 객체도 다른 객체에 대하여 모른다. 이것은 콤포넨트프로그람작성 
의 본질이다. 

한편 처리부는 보통의 C ++ 성원함수로서 표준 C ++ 호출규칙을 따른다. 

⑵ 동작 

LCD 수는 미 끄럼 띠 에 대 한 사용자의 모든 조작을 반영하며 창문부품은 크기 변경 을 
잘 조종한다. 창문크기 가 변경될 때 (그것 이 가능하기때 문에) LCD 수 창문부품의 크기는 
달라지지만 다른것은 거의 비슷하다. 

(3) 련습 

자리 수를 더 많이 추가하거 나 방식 을 바꾸어 LCD 수를 변경해 보시 오. 기 수를 설정 
하기 위하여 4개 의 누름단추를 추가할수 있 다. 

또한 미끄럼띠의 범위 를 변경할수 있다. 미끄럼 띠 보다 QSpinBox 를 사용하는것 이 
더 좋다. LCD 수가 넘어날 때 응용프로그람을 중지한다. 

6. 복잡한 블로크의 구죽 

이 실례는 새로운 구성요소로서 2개의 창문부품을 밀봉하는 방법과 많은 창문부품 
을 간단히 사용하는 방법 을 보여 준다. 처 음으로 사용자정 의 창문부품을 자식 창문부품으로 
사용한다. 
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그림 2-6. 복잡한 블로크의 구축 


#include 

#include 

#include 

#include 

#include 

#include 

■elude 


< qapplication . h > 
< qpushbutton . h > 
< qslider . h > 
< qlcdnumber . h > 
< qfont . h > 
< qvbox . h > 
< qgrid . h > 


class LCDRange : public QVBox 

{ 

public ： 

LCDRange ( QWidget * parent =0 ，const char * name =0 ) ； 


LCDRange ： : LCDRange( QWidget *parent, const char *name ) 
: QVBox( parent, name ) 

{ 

QLCDNumber *lcd = new QLCDNumber( 2, this, "led" ) ； 
QSlider * slider = new QSlider( Horizontal, this, ” slider” ) ； 
slider->setRange( 0, 99 )； 
slider->setValue ( 0 ) ； 

connect ( slider, SIGNAL (valueChanged (int)), led, 

SLOT (display (int)) )； 

} 

class MyWidget : public QVBox 

{ 

public ： 

MyWidget ( QWidget *parent=0, const char *name=0 ) ； 

}； 


MyWidget :: MyWidget ( QWidget * parent , const char *name ) 
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QVBox ( parent , name ) 

{ 

QPushButton *quit = new QPushButton ( " Quit ”, this , ’’ quit ” ) ； 
quit -> setFont ( QFont ( ’’ Times ”, 18, QFont： : Bold ) ) ； 

connect ( quit , SIGNAL (clicked ()), qApp , SLOT (quit 0) ) ； 

QGrid *grid = new QGrid ( 4, this ) ； 

for ( int r = 0 ； r < 4 ； r ++ ) 
for ( int c = 0 ； c < 4 ； C ++ ) 

( void ) new LCDRange ( grid ) ； 

} 


int main ( int argc , char **argv ) 

{ 

QApplication a ( argc , argv ) ； 

My Widget w ； 
a . setMainWidget ( &w ) ； 
w.showO ； 
return a . exec 0 ; 

} 

(1) 명령문설명 

class LCDRange : public QVBox 

{ 

public ： 

LCDRange ( QWidget * parent =0, const char * name =0 ) ； 

}； 

LCDRange 창문부품은 구성자만 가지는 창문부품이다. 창문부품의 이러한 분류는 
비효과적 이므로 몇 가지 API 를 후에 추가한다. 

LCDRange ： : LCDRange ( QWidget ^ parent , const char *name ) 

: QVBox ( parent , name ) 

{ 

QLCDNumber *lcd = new QLCDNumber ( 2, this , ’’ led ” ) ； 

QSlider * slider = new QSlider ( Horizontal , this , ” slider ” ) ； 
slider -〉 setRange ( 0, 99 ) ； 
slider->setValue ( 0 ) ； 

connect ( slider , SIGNAL (valueChanged ( int )), led , SLOT (display ( int )) ) ； 

} 

이것은 소절 5 에서 MyWidget 구성자로부터 직접 복사한다. 유일한 차이는 단추가 
없고 클라스이름이 달라진것이다. 

class MyWidget : public QVBox 

{ 

public ： 

MyWidget ( QWidget * parent =0, const char * name =0 ) ； 
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}; 

MyWidget 도 구성자를 제외한 어떤 API 도 포함하지 않는다. 

My Widget :: My Widget ( QWidget *parent, const char *name ) : 

QVBox( parent, name ) 

{ 

QPushButton *quit = new QPushBu 竹 on( "Quit", this, "quit" ); 

quit->setFont( QFont( "Times", 18, QFont ： ：Bold ) ); 

connect ( quit, SIGNAL (clicked ()), qApp, SLOT (quit ()) ); 

하나의 Quit 단추와 여러개 LCDRange 객체들을 가질수 있게 지금 LCDRange 에 
있는 누름단추를 분리한다. 

QGrid *grid = new QGrid( 4, this ); 

4 개 렬을 가지는 QGrid 객체를 만든다. QGrid 창문부품은 행과 렬에 자식들을 자동 
적 으로 배 치 하고 행 수 또는 렬 수를 지 정할수 있 으며 QGrid 는 새 로운 자식 들을 발견하 
고 그것들을 살창에 삽입한다. 

for( int r = 0 ； r < 4 ； r++ ) 
for( int c = 0 ； c < 4 ； C ++ ) 

(void) new LCDRange ( grid ); 

} 

살창객체의 자식들인 4X4 LCDRange 를 생성한다. QGrid 창문부품은 그것들을 배 
치 한다. 

(2) 동:작 

이 프로그람은 많은 창문부품을 한번에 사용하는 간단한 방법을 보여준다. 매개는 
앞의 소절에서 미끄럼띠와 LCD 수처럼 동작한다. 차이는 실현에 있다. 

(3) 련습 

기동할 때 매개 미끄럼띠를 각이한 우연수로 초기화하시오. 

원천은 ”4” 의 3 개 실현값을 포함한다. QGrid 구성자호출에서 그것을 변경하면 어떤 
일이 생기는가? 왜 그런가? 

7. 한 객체가 다른 객체를 유도하기 



그림 2-7. 한 객체가 다른 적체를 유도하기 
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이 실례는 신호와 처리부를 가지는 사용자정의창문부품들을 생성하여 모두 련결하 
는 방법 을 보여준다. 우선 t 7 보조등록부에 있는 여 러개의 파일들에 원천을 나누어 보관 
한다. 

• t 7/ lcdrange . 느는 LCDRange 들라스를 정 의 한다. 

• t 7/ lcdrange . cpp 는 LCDRange 를 실현한다. 

• t 7/ main . cpp 는 MyWidget 와 main 을 포함한다. 

(1) 명령문설명 

■ t 7/ lcdrange . h 

이 파일은 주로 소절 6의 main , cpp 로부터 옮겨온것으로서 달라진것만 설명한다. 
#ifndef LCDRANGE_H 
#define LCDRANGE_H 

이것은 전형적인 (내구성으로서 머리부파일을 한번이상 포함하여야 하는 경우 오유를 
피하게 한다. # ifndef 는 모든 머 리부파일을 둘러막아야 한다. 

#include < qvbox . h > 

qvbox . h 를 포함한다. LCDRange 는 QVBox 를 계승하므로 부모들라스의 머리부 
파일을늘 포함하여야 한다. 앞의 소절에서 qwidget . h 는 ^ pushbutton , h 와 같은 다른 
머 리부파일을 통하여 간접적 으로 포함된다. 
class QSlider ； 

이것은 다른 중요한 수법으로서 자주 사용된다. 클라스의 대면부에서 QSlider 를 
요구하지 않으므로 머리부파일에서 콜라스의 앞방향선언만 사용하고 실현에서만. cpp 파 
일에서 QSlider 의 머리부파일을 포함한다. 

이것은 머리부파일이 변경되였을 때 적은 파일들을 다시 름파일하게 하므로 큰 프 
로젝트의 콤파일을 훨씬 빠르게 한다. 즉 큰 프로젝트의 를파일을 2배이상 고속화할수 
있 다. 

class LCDRange : public QVBox 

{ 

Q_OBJECT 

public ： 

LCDRange ( QWidget * parent =0, const char * name =0 ); 

Q _ OBJECT 마크로는 신호나 처리부를 포함하는 모든 클라스들에 포함되여야 한다. 
필요하다면 메 타객 체파일 에 서 실현되 는 함수들을 정 의한다. 

int value 0 const ; 

public slots ： 
void setValue ( int ); 

signals ： 

void valueChanged ( int ); 

이 세개 성원은 프로그람에서 창문부품들과 다른 부분품들사이의 대면부를 만든다. 
지금까지 LCDRange 는 실제로 대면부를 전혀 가지지 않았다. 

valueO 는 LCDRange 의 값을 호출하기 위한 공개함수이다. setValueO 는 첫 사 
용자정 의 처 리부이 고 valueChangedO 는 첫 사용자정 의 신호이 다. 

처 리부들은 보통의 방법으로 실현되 여 야 한다. (처 리부도 C ++ 성원함수이 다.) 신호는 
자동적으로 메타객체파일에 실현되고 보호 C ++ 함수들의 호출규칙을 따른다. (즉 신호는 
자기가 정의되는 콜라스 혹은 그 기초콜라스에 의해서만 발생될수 있다.) 

신호 valueChangedO 는 LCDRange 의 값이 변할 때 사용된다. 
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② t 7/ lcdrange.cpp 

이 파일은 주로 t6 / main . cpp 로부터 옮기였으며 여기서는 달라진것만 설명한다. 
connect ( slider , SIGNAL (valueChanged ( int )), led , 

SLOT (display ( int )) ); 

connect ( slider , SIGNAL (valueChanged ( int )), 

SIGNAL (valueChanged ( int )) ) ； 

이 코드는 LCDRange 구성자로부터 발취한것 이 다. 

첫째 련결은 앞의 소절에서 본것과 같다. 둘째는 새로운것이다. 이것은 미끄럼띠의 
valueChanged 0신호를 이 객체의 valueChanged 신호에 련결한다. 3인수를 가진 
connectO 는 늘 이 객체에서 신호나 처리부들을 련결한다. 

신호는 다른 신호들에 련결될수 있다. 첫 신호가 발생될 때 둘째 신호도 발생된다. 
사용자가 미끄럼띠에 조작할 때 미끄럼띠는 그 값이 변경되면 valueChanged 0신 
호를 발생 한다. 이 신호는 QLCDNumber 의 display () 처 리부와 LCDRange 의 
valueChanged 0신호에 모두 련결된다. 

이리히여 신호가 발생될 때 LCDRange 는 그 자체의 valueChanged 0신호를 발 
생 한다. 또한 QLCDNumber ： : display ()^> 호출되 여 새 로운 수가 표시된다. 

LCDRange :: valueChanged 0는 QLCDNumber : : display 0전후에 발생될수 있 
고 그 실행순서는 따로 지정된것이 없다. 
int LCDRange ： : value () const 
{ 

return slider -> value () ； 

} 

valueO 의 실현은 간단하며 단순히 미끄럼띠의 값을 돌려준다. 
void LCDRange ： : setValue ( int value ) 

{ 

slider->setValue ( value ) ； 

} 

setValueO 의 실현도 간단하다. 미끄럼띠와 LCD 수가 련결되므로 미끄럼띠값의 설 
정은 자동적으로 LCD 수를 갱 신한다. 또한 미끄럼띠는 값이 범위를 벗 어나면 자동적으 
로 그것을 조절한다. 

③ t 7/ main.cpp 
LCDRange *previous = 0； 
for ( int r = 0 ； r < 4 ； r ++ ) { 

for ( int c = 0 ； c < 4 ； C ++ ) { 

LCDRange * lr = new LCDRange ( grid ) ； 
if ( previous ) 

connect ( lr , SIGNAL ( valueChanged ( int )), 
previous , SLOT ( setValue ( int )) ) ； 
previous = lr ； 

} 

} 

MyWidget 용구성자를 제외한 main . cpp 의 코드는 모두앞의 소절에서 복사하였다. 
16개의 LCDRange 객체를 창조할 때 현재는 신호-처리부기구를 사용하여 그것들을 련 
결한다. 매개 객체는 앞 객체의 setValueO 처리부와 련결된 valueChanged 0신호를 
가전다. LCDRange 는 값이 변화할 때 신호 valueChanged 0를 발생하므로 여기서는 
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신호와 처리부들의 《사슬》을 창조한다. 

(2) 름파일 

여러파일 응용프로그람용 makefile 의 창조는 단일파일응용프로그람용 makefile 의 
창조와 다르다. 자체의 등록부에 이 실례의 모든 파일들을 보관하였다면 다음과 같이 해 
야 한다. 

qmake -project 

qmake 

첫 지령은 qmake 가 . pro (프로젝트)파일을 창조한다. 둘째 지령은 프로젝트파일에 
기초하여 가동환경에 고유한 makefile 을 창조한다. 이제는 make (혹은 Visual Studio 
를 사용하는 경우 nmake ) 를 입력하여 응용프로그람을 구축할수 있다. 

(3) 동작 

기동할 때 프로그람의 창문은 이전과 같다. 

(4) 련습 

오른쪽 아래의 미끄럼띠를 사용하여 모든 LCD 를 50으로 설정한다. 그다음 미끄럼 
띠 손잡이 의 왼쪽을 한번 찰칵하여 우의 절 반을 40으로 설 정한다. 그러 면 마지 막으로 조 
작한것의 왼쪽에 있는 미끄럼띠를 사용하여 처음의 7개 LCD 들을 50으로 설정한다. 

오른쪽 아래에 있는 미끄럼띠 손잡이의 오른쪽을 찰칵한다. 어떤 일이 생기는가? 
왜 이것이 정확한 동작으로 되는가? 

8. 전투준비 

이 실례에서는 자체로 그릴수 있는 첫 사용자정의창문부품을 소개한다. 또한 두행 
의 코드로 쓸모있는 건반대면부를 추가한다. 

• t8 / lcdrange . h 는 LCDRange 콜라스를 정의 한다. 

• t8 / lcdrange . cpp 는 LCDRange 를 실현한다. 

• t8 / cannon . h 는 CannonField 콜라스를 정의 한다. 

• t8 / cannon . cpp 는 CannonField 를 실현한다. 

• t8 / main . cpp 는 MyWidget 와 main 을 포함한다. 



그림 2-8 . 전투준비 
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(1) 명령문설명 

① t8/lcdrange.h 

이 파일은 소절 7의 lcdrange.h 와 아주 비슷하다. 하나의 처리부 setRangeO 를 
추가한다. 

void setRange( int minVal, int maxVal ) ； 

이제 LCDRange 의 범위설정기능을 추가한다. 현재 0〜99로 고정한다. 

② t8/lcdrange.cpp 
구성 자를 변경 한다. 

void LCDRange :: setRange ( int minVal, int maxVal ) 

{ 

if ( minVal < 0 | | maxVal > 99 | | minVal > maxVal ) { 
qWarning( "LCDRange： ：setRange(%d, %d)\n” 

"XtRange must be 0..99\n” 

”\tand minVal must not be greater than maxVal’’, minVal, 
maxVal ) ； 
return； 

} 

slider-〉setRange( minVal, maxVal ) ； 

} 

setRangeO 는 LCDRange 에서 미끄럼띠의 범위를 설정한다. 항상 두자리를 현시 
하도록 QLCDNumber 를 설정하였으므로 minVal 과 maxVal 의 가능한 범위를 0 〜99로 제 
한하여 QLCDNumber 의 자리넘 침을 피 하려 고 한다. 인수가 옳지 않으면 Qt 의 
qWarningO 함수에 의하여 사용자에게 경고를 내고 즉시 되돌아간다. qWarningO 은 
기 정 으로 출력 을 stden •에 보내 는 printf 형 식 의 함수이다. 필요하다 
면 : :QlnstallMsgHandler() 에 의 해 자체 의 처 리 함수함수를 설 치 할수 있다. 

③ t8/cannon.h 

CannonField 는 자기를 현시하는 방법을 알고있는 새로운 사용자정의창문부품이다. 
class CannonField : public QWidget 
{ 

Q_OBJECT 

public： 

CannonField ( QWidget *parent=0, const char *name=0 ) ； 

CannonField 는 QWidget 를 계승하며 LCDRange 에서와 류사한 성원들을 사용한다. 
int angle() const { return ang； } 

QSizePolicy sizePolicyO const； 
public slots： 

void setAngle( int degrees ) ； 
signals： 

void angleChanged( int ); 

CannonField 는 오직 LCDRange 의 값대신에 각도를 리용하는 대면부를 제공한다. 
protected： 

void paintEvent( QPaintEvent * ) ； 

이것은 QWidget 의 수많은 사건처리함수중에서 두번째로 만나는것이다. 이 가상함수는 창 
문부품이 자체를 갱신해 야 할 때마다 Qt 에 의 해 호출된다. (즉 창문부품의 표면을 그린다.) 

④ t8/cannon.cpp 

CannonField： : CannonField( QWidget *parent, const char *name ) 
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: QWidget ( parent, name ) 

{ 

앞의 소절에서 LCDRange 와 비슷한 성원함수들을 사용한다 . 
ang = 45 ； 

setPalette( QPalette( QColor( 250, 250, 200) ) ); 

} 

구성자는 각도값을 45 도로 초기화하고 이 창문부품용의 사용자정의조색판을 설정한다 . 
이 조색판은 지 적된 색 을 배 경 으로 사용하고 다른 색들을 적 당히 선택한다 . (이 창 
문부품에서는 오직 배경과 본문색만 실제로 사용한다 .) 
void CannonField： : set Angle ( int degrees ) 

{ 

if ( degrees < 5 ) 
degrees = 5 ； 
if ( degrees > 70 ) 
degrees = 70 ； 
if ( ang == degrees ) 
return ； 

ang = degrees; 
repaint 0; 

emit angleChanged( ang ); 

} 

이 함수는 각도값을 설정한다 . 범위 를 5 〜 70 으로 선택 하고 그에 따라 도수를 조절 
한다 . 새 각도가 범위 를 벗 어나면 경 고를 내지 않도록 선택한다 . 

새로운 각도가 낡은 값과 갈으면 즉시 되돌아간다 . 각도가 실제로 변했을 때 신호 
angleChangedO 를 발생 하는것만 중요하다 . 

그다음 새로운 각도값을 설정 하고 창문부품을 다시 그린다 . QWidget :: repaint() 
함수는 창문부품을 지우고(보통 배경으로 채운다 .) 창문부품에 그리기사건을 보낸다 . 이 
리 하여 창문부품의 그리 기사건함수호출이 발생 한다 . 

끝으로 angleChangedO 신호를 발생 하여 외부에 각도가 변화하였다고 전한다 . 
emit 예약어는 Qt 에만 있으며 표준 C ++ 문법이 아니다 . 사실상 그것은 마크로이다 . 
void CannonField: :paintEvent( QPaintEvent * ) 

{ 

QString s = "Angle = " + QString:: number ( ang ) ； 

QPainter p( this ) : 
p.drawText( 200, 200, $，)； 

} 

이것은 그리기사건처리함수에 써넣기 위한 첫 시도이다 . 사건인수는 그리기사건의 
서술을 포함한다 . QPaintEvent 는 갱신해야 할 창문부품안의 령역을 포함한다 . 전부 
그리므로 시간적으로 뜨다 . 

코드에서는 창문부품안의 각도값을 고정위치에 현시한다 . 우선 본문과 각도를 가지 
는 QString 을 창조한 다음 이 창문부품에 조작하는 QPainter 를 창조하고 그것을 리용 
하여 문자렬을 그린다 . 후에 QPainter 에서 많은 일을 수행한다 . 

⑥ t8/main.cpp 
#include "cannon, h" 

새로운 들라스를 포함한다 . 
class My Widget : public QWidget 
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{ 

public ： 

My Widget ( Q Widget *parent=0, const char *narae=0 ); 

}； 

이번에는 하나의 LCDRange 와 하나의 CannonField 를 제일웃준위창문부품에 포 
함한다 . 

LCDRange *angle = new LCDRange( thi|* "angle" ); 

구성 자에서는 LCDRange 를 창조하고 설정한다 . 
angle->setRange( 5, 70 )l 

LCDRange 의 범 위 를 5 〜 70 도로 설 정한다 . 

CannonField *cannonField '유 new CannonField ( this, 

"cannonField” ) : 

CannonField 를 창조한다 . 

connect ( angle, SIGNAL (valueChanged (int)), CannonField, 

SLOT (setAngle (int)) )» 

connect ( CannonField, SIGNAL (angleChanged (int)), angle, 
SLOT (set Value (int)) )； 

여기서는 CannonField 의 setAngleO 처리부에 LCDRange 의 valueChanged() 
신호를 련결한다 . 이것은 사용자가 LCDRange 를 조작할 때마다 CannonField 의 각도 
값을 갱신한다 . 또한 반대련결을 만들어 CannonField 에서의 각도변경이 LCDRange 
값을 갱신하게 한다 . 실례에서는 CannonField 의 각도를 직접 변경하지 않지만 마지막 
connectO 를 수행하여 앞으로의 변경이 그 두개 값들사이의 동기화를 파피하지 않는다 
는것을 담보한다 . 

이 것은 를퓨넨트프로그람작성 법의 능력 과 적 당한 밀봉성 을 설명 한다 . 

실제로 각도가 변경될 때만 angleChanged 0 신호를 발생하는것이 얼마나 중요한가 
를 알아야 한다 . LCDRange 와 CannonField 가 둘다 이 검사를 생략하면 프로그람은 
값들중 하나의 첫 변경에 대하여 무한순환에 들어간다 . 

QGridLayout *grid = new QGridLayout( this, 2, 2, 10 ); 

//2x2, 10 pixel border 

지금까지는 조립이 필요하지 않은 QVBox 와 QGrid 창문부품들을 기하학적관리에 
사용하였다 . 그러나 이제는 배치관리자를 좀 더 조절하여 강력한 QGridLayout 클라스 
로 절환한다 . QGridLayout 는 창문부품이 아니고 임의의 창문부품의 자식들을 관리할 
수 있는 다른 들라스이다 . 

설명 문에 서 보여 주는것 처 럼 10 화소테 두리 를 가지 는 2X2 배 렬 을 창조한다 . 

(QGridLayout 용 구성자는 좀 신비스러우므로 설명문을 넣는것이 좋다 .) 
grid->addWidget( quit, 0,0 )； 

살창의 제 일왼쪽세포 0, 0 에 Quit 단추를 추가한다 . 
grid->addWidget( angle, 1, 0, Qt： : AlignTop ) : 

세포의 꼭대기와 일직선되는 왼쪽바닥세포에 각도 LCDRange 를 놓는다 . (이러한 
배렬은 QGridLayout 는 허용하지만 QGrid 는 허용하지 않는것들중의 하나이다 .) 
grid->addWidget( CannonField, 1, 1 ); 

오른쪽아래 세 포에 CannonField 객 체 를 놓는다 . (오른쪽웃끝세 포는 비 여 있 다 . ) 
grid->setColStretch ( 1, 10 ); 

오른쪽란(렬 1 ) 을 신축할수 있다는것을 QGridLayout 에게 알린다 . 왼쪽란이 없으므 
로(그것은 기정신축곁수 0 을 가진다 .) QGridLayout 는 왼쪽창문부품들의 크기가 변경 
되지 않게 하려고 하며 MyWidget 의 크기가 조절될 때 CannonField 를 조절한다 . 
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angle->setValue ( 60 ); 

초기각도값을 설정한다 . 이것은 련결을 LCDRange 로부터 CannonField 로 절환한다 . 
angle->setFocus 0; 

마지막으로 할 일은 각도가 건반초점을 가지도록 설정하여 건반입력이 기정으로 
LCDRange 창문부품으로 가도록 하는것이다 . 

LCDRange 는 어떤 keyPressEventO 도 포함하지 않으므로 그리 쓸모있지 않는다 . 
그러나 구성자는 새 행을 엄는다 . 
setFocusProxy( slider ); 

LCDRange 는 미끄럼띠를 그 초점대리로 설정한다 . 이것은 프로그람 혹은 사용자 
가 LCDRange 건반초점을 주려고 할 때 미끄럼띠가 그것을 고려해야 한다는것을 의미 
한다 . QSlider 는 괜찮은 건반대면부를 가지므로 바로 한행의 코드에 의해 LCDRange 
의 대면부를 주었다 . 

(2) 동작 

지금 건반은 동작하며 방향건， Home, End, PageUp 와 PageDown 은 모두 막연 
하게 느낄수 있는 일을 수행한다 . 

미끄럼띠가 조작되면 CannonField 는 새로운 각도값을 현시한다 . 크기조절할 때 
CannonField 는 될 수록 많은 공간을 차지 한다 . 

8bit 현시 기 를 가지 는 Windows 콤퓨터들에서 새 로운 배 경 색 이 떨 린다.다음 항은 이 
에 대하여 작업한다 . 

(3) 련습 

창문의 크기를 조절하시오 . 창문을 줄이면 어떤 일이 생기는가 ? 

AlignTop 를 삭제하면 LCDRange 의 위치와 크기가 어떻게 되는가 ? 무엇때문인가 ? 

왼쪽란에 령아닌 신축곁수를 준다면 창문크기를 조절할 때 어떤 현상이 생기는가 ? 

QButton: :setText() 호출에서 "Quit” 를 "&Quit” 로 변경해보시오 . 단추의 형식 이 
어떻게 변하는가 ? 프로그람을 실행할 때 Alt+Q (일부 건반에서 Meta+Q) 를 누르면 어떤 
일이 생기는가 ? 

본문을 CannonField 의 중심에 배치하시오 . 

9. 포쏘기 

이 실례 에서는 작고 매 력있는 청색포를 그린다 . cannon.cpp 만 앞항과 다르다 . 



그림 2-9 . 포쏘기 
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• t 9/ lcdrange . h 는 LCDRange 둘라스를 정의 한다. 

• t 9/ lcdrange . cpp 는 LCDRange 실현을 포함한다. 

• t 9/ cannon , h 는 CannonField 클라스를 정의 한다. 

• t 9/ cannon , cpp 는 CannonField 실현을 포함한다. 

• t 9/ main . cpp 는 MyWidget 와 main 을 포함한다. 

(1) 명령문설명 

■:① t 9/ cannon , cpp 

void CannonField : : paintEvent ( QPaintEvent * ) 

{ 

QPainter p ( this ) : 

이제는 QPainter 를 진지하게 사용한다. 이 창문부품에 조작하는 그리기객체 
( painter ) 을 창조한다. 

p . setBrush ( blue ); 

QPainter 는 직 4 각형, 원 혹은 다른것을 색칠할 때 자기 솔을 사용한다. 여기서는 
청색솔을 사용하도록 설정한다. (또한 패턴을 사용할수 있다.) 
p . setPen ( NoPen ); 

그리고 QPainter 가 테두리를 그릴 때는 펜을 사용한다. 여기서는 NoPen 으로 설 
정하는데 이것은 그릴 때 테두리가 없으며 청색솔을 사용한다는것을 의미한다. 
p . translate ( 0， rect (). bottom () ); 

QPainter : translate () 함수는 QPainter 의 자리 표계 를 변환한다. 즉 변위만큼 그 
것을 이동한다. 여기서는 창문부품의 왼쪽아래구석을 점 (0， 0) 으로 설정한다. 표와 모방 
향은 변하지 않는다. 즉 창문부품안의 모든 y 자리표는 현재 부수이다 ( Qt 의 자리표계에 
대 한 자세 한 정 보는 5장 3절 참고) . 

p . drawPie ( QRect (-35, -35, 70, 70), 0, 90*16 ); 

drawPieO 함수는 시 작각도와 호의 길이를 리용하여 특정한 직4각형안에 부채형을 
그린다. 각도는 도의 1/16로 지정된다. 령도는 3시위치，그리기방향은 시계바늘과 반대 
방향이다. 여기서는 창문부품의 왼쪽아래구석의 4분의 1을 그린다. 부채형은 청색으로 
도색되고 테두리선이 없다. 
p . rotate ( -ang ); 

QPainter : : rotate () 함수는 원점을 중심으로 QPainter 의 자러표계를 회전시킨다. 회 
전인수는 도수로 주어진 float 이며(우와 같이 도의 1/16로 주어지지 않는다.) 시 계 바늘과 
반대방향이다. 여기서는 자리표계를 시계바늘이 도는 방향과 반대로 ang 도만큼 회전시킨다. 
p . drawRect ( QRect (33, -4, 15, 8) ); 

QPainter : : drawRect () 함수는 지정된 직4각형을 그린다. 여기서는 포신을 그린다. 

우와 같이 자리표계가 변하였을 때 (변환, 회전，확대축소，혹은 잘라냈을 때) 결과 
를 상상하기 힘들수 있다. 

이 경우에 우선 자리표계가 변환되고 그다음 회전된다. 직4각형 QRect (33, -4, 
15, 8) 이 변환된 자러표계에서 그려지면 다음과 같이 보일수 있다. 



직4각형이 CannonField 창문부품의 경계에 의해 잘리운다. 자리표계를 가령 60도 
회전할 때 직4각형은 (0， 0) 를 중심으로 회전하며 자리표계를 변환하였으므로 이것은 
왼쪽아래구석이다. 결과는 다음과 같다. 
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이번에는 창문이 왜 떨리지 않았는가만 설명하지 않았다. 
int main ( int argc , char **argv ) 

{ 

QApplication ： : setColorSpec ( QApplication ： ：CustomColor ); 

QApplication a ( argc , argv ) : 

이 프로그람에 다른 색할당전략을 사용한다고 Qt 에게 알린다. 단일하고 정 확한 색 
할당전략은 없다. 이 프로그람이 수많은 색이 아니라 황색을 사용하므로 CustomColor 가 
제일 좋다. 몇가지 할당방식이 있으며 QApplica 吐 on :: setColorSpec () 문서에서 그것들 
을 읽을수 있다. 

대체로 기정이 좋으므로 이것을 무시한다. 우연적으로 비일반색을 사용하는 응용프 
로그람들은 나쁘게 보이며 할당전략의 변경이 흔히 그 프로그람들을 방조한다. 

(2) 동작 

미끄럼띠를 조작할 때 그려진 포의 각도가 그에 따라 변한다. 

Quit 단추의 Q 에 는 현재 밑줄이 놓이 고 Alt + Q 는 중지작용을 수행한다. 그 리 유를 
모르면 8.의 련습을 하지 않았기때문이다. 

느린 름퓨터에서 포가 특별히 깜빡거린다는것을 알수 있다. 다음 항에서 이것을 고 
착시 킨다. 

(3) 련습 

NoPen 대신에 다른 펜을 설정하시오. 패런솔을 설정하시오. 

단추본문을 "& Quit " 대신에 " Q & uit " 혹은 " Qu & it " 로 하시오. 어떤 일이 생기는가? 

10. 명주처럼 부드럽게 

이 실례에서는 깜빡거림을 없애기 위한 픽스매프그리기를 소개한다. 또한 힘조종요 
소를 추가한다. 



그림 2-10 . 힘조종요소의 추가 
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• tlO / lcdrange . h 는 LCDRange 클라스를 정의 한다. 

• tlO / lcdrange . cpp 는 LCDRange 실현을 포함한다. 

• tlO / cannon . h 는 CannonField 클라스를 정의 한다. 

• tlO / cannon . cpp 는 CannonField 실현을 포함한다. 

• tlO / main . cpp 는 MyWidget 와 main 을 포함한다. 
(1) 명령문설명 

① tlO / cannon.h 

이제 CannonField 는 각도와 함께 힘값을 가전다. 
int angle () const { return ang ； } 
int force 0 const { return f ； } 


public slots ： 

void setAngle ( int degrees ) ； 
void setForce ( int newton ) ； 


signals ： 

void angleChangedC int ) ； 
void forceChanged ( int ) ； 

힘에 대한 대면부는 실제상 각도에서와 같다. 
private ： 

QRect cannonRectO const ； 

개별적인 함수안에 포를 둘러싸는 직4각형의 정의를 넣는다. 
int ang ； 
int f ； 

}； 

힘은 꾼에 보관된다. 

② tlO / cannon.cpp 
#include < qpixmap . h > 

QPixmap 클라스를 정의한다. 

CannonField ： : CannonField ( QWidget * parent , const char *name 
: QWidget ( parent , name ) 

{ 

ang = 45； 
f = 0 J 

setPalette ( QPalette ( QColorC 250, 250, 200) ) ) ； 

} 

힘 ( f ) 은 0 으로 초기 화된다. 
void CannonField ： : setAngle ( int degrees ) 

{ 

if ( degrees < 5 ) 
degrees = 5； 
if ( degrees > 70 ) 
degrees = 70; 
if ( ang == degrees ) 
return ； 
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ang = degrees ； 

repaint ( cannonRectO, FALSE ) ； 
emit angleChanged( ang ) ； 

} 

setAngleO 함수를 약간 변경하고 포를 포함하는 창문부품부분만 다시 그린다. 
FALSE 인수는 그리기사건이 창문부품에 보내지기전에 지정된 직 4 각형을 지우지 말아야 
한다는것을 지정한다. 이것은 그리기를 좀 더 빠르고 유연하게 한다. 
void CannonField： : setForce( int newton ) 

{ 

if ( newton < 0 ) 
newton = 0； 
if ( f == newton ) 
return； 
f = newton ； 
emit forceChanged( f ) ； 

} 

setForceO 의 실현은 setAngleO 과 비슷하다. 유일한 차이는 힘값을 표시하지 않 
으므로 창문부품을 다시 그릴 필요가 없는것이다. 

void CannonField： : paintEvent( QPaintEvent *e ) 

{ 

if ( !e->rectO.intersects( cannonRectO ) ) 
return； 

이제는 갱신이 요구되는 창문부품부분만 다시 그리도록 그리기사건을 최적화한다. 우선 
무엇 인가 그려 야 하는가 검 사하고 그렇지 않으면 되돌아간다. 

QRect cr = cannonRectO ； 

QPixmap pix( cr. sizeO ) ； 

그다음 깜빡거 림 이 없는 그리 기 에 사용할 일시 픽 스매 프를 창조한다. 모든 그리 기 조작은 
이 픽 스매 프에 수행 된 다음 픽 스매 프는 단일 조작으로 화면 에 그려 전다. 

이것은 깜빡거 림 이 없는 그리기의 본질이 다. 즉 매개 화소에 정확히 한번 그린다. 드문히 
그리기오유가 생기고 깜빡거림이 많이 생긴다. 이 실례에서는 문제가 없다. 코드를 썼을 때 여 
전히 깜빡거 림 때 문에 를퓨터 가 느리 다. 

pix.fill( this, cr.topLeftO ) ； 

이 창문부품으로부터 픽스매프를 배경으로 채운다. 

QPainter p( 技 pix ) ； 

p.setBrush( blue ) ； 

p.setPen( NoPen ) ； 

p. translate( 0, pix. height() - 1 ) ； 

p.drawPie( QRect( -35,-35, 70, 70 ), 0, 90*16 ) ； 

p. rotate ( -ang ) ； 

p.drawRect( QRect(33, -4, 15, 8) ) ； 
p.endO ； 

소절 9 에서처럼 그리지만 현재 픽 스매프 안에 그린다. 

이 시점에서는 그리기객체와 픽스매프를 가지지만 여전히 화면에 그려지지 않는다. 
p. begin ( this ) ； 

p.drawPixmap( cr.topLeftO, pix ) ； 

그러므로 CannonField 자체가 그리기객체를 열고 픽스매프를 그린다. 
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꼭대기의 두행과 아래의 두행 그리고 깜빡거 림은 전혀 없다. 

QRect CannonField ： : cannonRectO const 

{ 

QRect r ( 0，0， 50, 50 ); 
r . moveBottomLeft ( rectO . bottomLeftO ); 
return r ； 

} 

이 함수는 창문부품자리 표계 에 서 포를 둘러 싸는 직4각형 을 돌려 준다. 우선 50 X 50 크기 를 
가지는 직4각형 을 창조하고 그것 을 이동하여 그 왼쪽아래 구석 이 창문부품자체의 왼쪽아래 구 
석 과같아지 게 한다. 

QWidget::rectO 함수는 창문부품자체의 자리표로 창문부품이 내접하는 직4각형을 
돌려준다. (여기서 왼쪽웃구석은 0, 0이다.) 

© tlO / main.cpp 

My Widget :: My Widget ( QWidget * parent , const char *name ) 

: QWidget ( parent , name ) 

{ 

구성 자는 기 본적 으로 같지 만 일부 새 로운것 이 추가되 였 다. 

LCDRange *force = new LCDRange ( this , " force " ); 
force->setRange ( 10, 50 ); 

힘설정에 사용하는 두번째 LCDRange 를 추가한다. 
connect ( force , SIGNAL (valueChanged ( int )), cannonField , 

SLOT (setForce ( int )) ) : 

connect ( cannonField , SIGNAL (forceChanged ( int )), force , 

SLOT (set Value ( int )) )； 

angle 창문부품에 대하여 수행한것처럼 force 창문부품과 cannonField 창문부품을 
련결 한다. 

QVBoxLayout *leftBox = new QVBoxLayout : 
grid -> addLayout ( leftBox , 1, 0 ); 
leftBox->addWidget ( angle ); 
leftBox->addWidget ( force ); 

소절 9 에서 배치관리자의 왼쪽아래세포에 angle 을 놓는다. 이제 그 세포에 두개 
창문부품을 넣으려고 하므로 수직칸을 만들고 살창세포에 수직칸을 넣고 angle 과 
range 를 수직칸에 넣 는다. 

force -> setValue ( 25 ); 

힘값을 25로 초기화한다. 

(2) 동작 

깜빡거림은 없어지고 힘조종요소를 가지게 되였다. 

(3) 련습 

포신의 크기가 힘 에 의존하게 하시오. 

오른쪽아래구석에 포를 놓는다. 

더 좋은 건반대 면부를 추가하시 오. 실례 로 +와 -로 힘 을 증가감소시키 고 사격하도 
록 하시오. 

암시 : QAccel 과 LCDRange 에서 QSlider : : addStep () 와 같은 새 로운 addStepO 
와 subtractStepO 처리부들, 왼건과 오른건의 동작 (I 와 !) 도 변경하시오. 
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11. 사격하기 

이 실례에서는 동화적인 사격을 실현하기 위한 시계를 소개한다. 



그림 2-11 . 사격 

• tll / lcdrange . h 는 LCDRange 콜라스를 정 의 한다. 

• tll / lcdrange.cpp 는 LCDRange 실현을 포함한다. 

• tl 1/ cannon.h 는 CannonField 클라스를 정의한다. 

• til / cannon.cpp 는 CannonField 실현을 포함한다. 

• tll / main.cpp 는 MyWidget 와 main 을 포함한다. 

(1) 명령문설명 

① tl 1 / cannon , h 

현재 CannonField 는 사격능력을 가지고있다. 
void shoot () : 

이 처리부호출은 포탄이 공중에 없으면 포를 쏘게 한다. 
private slots ： 
void moveShotO ； 

이 비공개처리부는 QTimer 를 사용하여 포탄이 공중에 있는동안 포탄을 이동하는데 
쓰인다. 

private : 

void paintShot ( QPainter * ); 

이 비 공개함수는 포탄을 그린 다. 

QRect shotRectO const ； 

이 비 공개함수는 포탄이 공중에 있으면 포탄이 내 접 하는 직 4각형 을 돌려 주며 그렇 
지 않으면 직4각형은 정의되지 않는다. 
int timerCount ； 

QTimer * autoShootTimer ； 
float shoot _ ang ； 
float shoot_f ； 

}； 
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이 비 공개변수들은 포탄을 서 술하는 정 보를 포함한다. timerCount 는 포탄이 발사된 
후부터 경 과된 시 간을 보관한다. shoot_ang 은 사격 할 때 포의 각도이 고 shoot_f 는 포의 
힘이다. 

② tl 1 / cannon , cpp 
#include < math . h > 

sinO 과 cosO 함수들이 필요하므로 수학서고를 포함한다. 

CannonField ： : CannonField ( QWidget * parent , const char *name ) 

: QWidget ( parent , name ) 

{ 

ang = 45； 
f = 0； 

timerCount = 0； 

autoShootTimer = new QTimer ( this , "movement handler " ) ； 
connect ( autoShootT imer , SIGNAL (timeout ()), this , 

SLOT (moveShot ()) ) ； 
shoot_ang = 0； 
shoot_f = 0； 

setPalette ( QPalette ( QColor ( 250, 250, 200) ) ) ； 

} 

새 로운 비 공개 변수들을 초기 화하고 QTimer : : timeout () 신호를 moveShotO 처 리 부 
에 련결한다. 시계가 시간을 요구할 때마다 포탄을 이동한다. 
void CannonField ： : shoot () 

{ 

if ( autoShootTimer -〉 is Active () ) 
return ； 

timerCount = 0； 
shoot_ang = ang ； 
shoot_f = f ； 

autoShootTimer -〉 start ( 50 ) ； 

} 

이 함수는 공중에 포탄이 없으면 포탄을 발사한다. timerCount 는 0 으로 재설정된다. 
shoot_ang 과 shoot_f 는 현재 포의 각도와 힘으로 설정된다. 끝으로 시계를 기동한다. 
void CannonField： : moveShotO 
{ 

QRegion r ( shotRectO ) ； 
timerCount ++； 

QRect shotR = shotRectO ； 


if ( shotR . x () > width () || shotR . y () > height () ) 
autoShootTimer->stop () ； 
else 

r = r . unite ( QRegion ( shotR ) ) ； 
repaint ( r ) ； 

} 

moveShotO 는 포탄을 이동하는 처리부로서 QTimer 가 발화되는 50 ms 간격으로 
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호출된다 . 

이 처리부는 새 위치를 계산하고 새 위치에 포탄이 있는 화면을 다시 그리고 필요 
하다면 시계를 중지한다 . 

우선 낡은 shotRectO 를 보유하는 QRegion 을 만든다 . QRegion 은 어떤 부류의 
령역이나 보관할수 있으며 여기서는 그것을 사용하여 그리기를 단순화한다 . shotRectO 
는 현재 포탄이 내접하는 직 4 각형을 돌려준다 . 

그다음 timerCount 를 증가시키는데 이것은 포탄을 그 궤도를 따라 한걸음 이동하는 
효과를 가전다 . 

다음에 새로운 포탄직 4 각형을 계산한다 . 

포탄이 창문부품의 오른변이 나 밑 변을 지 나가면 시계 를 중지하거 나 새 로운 
shotRectO 를 QRegion 에 추가한다 . 

끝으로 QRegion 을 다시 그린다 . 이것은 갱신을 요구하는 하나이상의 직 4 각형들에 
하나의 그리기사건을 보낸다 . 

void CannonField： : paintEvent( QPaintEvent *e ) 

{ 

QRect updateR = e->rectO ； 

QPainter p( this ) ； 


if ( updateR. intersects ( cannonRectO ) ) 
paintCannon ( 技 p ); 
if ( autoShootTimer->isActive () 技技 
updateR.intersects( shotRectO ) ) 
paintShot( 技 p ) ； 

} 

그리기사건함수는 앞항에서부터 둘로 분리하였다 . 이제 그리기가 요구되는 령역의 
경계직 4 각형을 추출하고 그것이 포 또는 필요하다면 포탄과 교차하는가 검사하고 
paintCannon() 혹은 paintShotO 를 호출한다 . 

void CannonField ： : paintShot( QPainter *p ) 

{ 

p->setBrush ( black ); 
p->setPen ( NoPen ) ； 
p->drawRect( shotRectO ) ； 

} 

이 비 공개함수는 검 은색 의 직 4 각형 으로 포탄을 그린 다 . 
paintCannon() 의 실현은 앞의 소절에서 paintEventO 와 같다 . 

QRect CannonField： : shotRectO const 

{ 

const double gravity = 4 ； 

double time = timerCount / 4.0 ； 

double velocity = shoot_f ； 

double radians = shoot_ang*3.14159265/180; 

double velx = velocity*cos ( radians ) ； 
double vely = velocity*sin ( radians ) ； 
double xO = ( barrelRect. rightO + 5 ) *cos (radians); 
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double yO = ( barrelRect. rightO + 5 )*sin(radians); 
double x = xO + velx*time ； 

double y = yO + vely*time - 0.5*gravity*time*time ； 

QRect r = QRect( 0 ， 0, 6, 6 ); 

r. moveCenter( QPoint( qRound(x), height() - 1 - qRound(y) ) ); 
return r ； 

} 

이 비공개함수는 포탄의 중심점을 계산하고 포탄이 내접하는 직 4 각형을 돌려준다 . 이 
것은 초기의 포힘과 각도，그리 고 시 간이 지 남에 따라 증가하는 timerCount 를 사용한다 . 

사용한 식 은 중력마당에 서 쓸림없는 운동에 관한 전형 적 인 뉴톤의 공식 이 다 . 단순 
성 을 위하여 아인슈타인효과를 무시하도록 선택한다 . 

y 자리표가 우로 증가하는 자리표계 에 서 중점 을 계 산한다 . 중점 을 계 산한 다음 6H 
6 의 크기 로 QRect 를 구성 하고 그 중점을 우에서 계산한 점 으로 이동한다 . 같은 조작으 
로 그 점을 창문부품의 자리표계로 변환한다 (5 장 3 절 참고 ). 

qRoundO 함수는 qglobal.h 에서 정의된 inline 함수이다 . (다른 모든 Qt 머 리부파 
일들에 의해 포함된다 .) qRoundO 는 double 을 제일 가까운 옹근수로 둥그리기한다 . 

■③ tll/main.cpp 

class My Widget : public QWidget 

{ 

public ： 

My Widget ( QWidget *parent=0, const char *name=0 ); 

}； 

유일한 추가는 Shoot 단추이 다 . 

QPushButton *shoot = new QPushBu 竹 on( "技 Shoot", this, "shoot" ); 
shoot->setFont( QFont( "Times", 18, QFont： : Bold ) ); 

구성자에서는 Quit 단추에서와 꼭같이 Shoot 단추를 창조하고 설정한다 . 구성자의 
첫인수는 단추본문이고 셋째 인수가 창문부품의 이름이다 . 

connect ( shoot, SIGNAL (clicked ()), cannonField, SLOT (shoot ()) ); 
Shoot 단추의 clicked0 신호를 cannonField 의 shootO 처리부에 련결한다 . 

⑵ 동작 

포를 사격할수 있으나 사격할것이 없다 . 

(3) 련습 

포탄을 색있는 원으로 만드시오 . 암시 : QPainter::drawEllipse() 를 리용할수 있다 . 
포탄이 공중에 있을 때 포의 색을 변경하시오 . 


12. 공중에 목표를 띄우기 

이 실례에서는 LCDRange 콜라스를 확장하여 본문표식자를 포함한다 . 또한 사격동 
작을 제공한다 . 
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그림 2-1 2. 목표를 띄우기 

• tl2/lcdrange.h 는 LCDRange 콜라스를 정의 한다 . 

• tl2/lcdrange.cpp 는 LCDRange 실현을 포함한다 . 

• tl2/cannon.h 는 CannonField 클라스를 정의 한다 . 

• tl2/cannon.cpp 는 CannonField 를 실현한다 . 

• tl2/main.cpp 는 MyWidget 와 main 을 포함한다 . 

(1) 명령문설명 

① tl2/lcdrange.h 

현재 LCDRange 는 본문표식자를 가지고있다 . 
class QLabel ； 

클라스정의에서 QLabel 의 지적자를 사용하려고 하므로 그 클라스를 선언한다 . 
class LCDRange : public QVBox 
{ 

Q—OBJECT 

public ： 

LCDRange ( QWidget *parent=0，const char *name=0 ) ； 

LCDRange ( const char *s，QWidget *parent=0, const char *name=0 ) ； 
parent, name 과 함께 표식자본문을 설정하는 새로운 구성자를 추가하였다 . 

const char *text () const ； 

이 함수는 표식자본문을 돌려준다 . 

void setText( const char * ) ； 

이 처리부는 표식자본문을 설정한다 . 
private : 
void initO ； 

현재 두개의 구성자를 가지므로 비공개 initO 함수에 공동초기화를 넣기로 선택하였다 . 
QLabel *label; 

또한 새로운 비공개변수 즉 QLabel 을 가전다 . QLabel 은 Qt 의 표준창문부품들중 
하나이 고 틀이 있거 나 없는 본문이 나 픽 스매 프를 표시할수 있 다 . 
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② tl2/lcdrange.cpp 
#include <qlabel.h> 

여기서 QLabel 클라스를 정의한다 . 

LCDRange： : LCDRange( QWidget *parent， const char *name ) : 

QVBox( parent, name ) 

{ 

initO; 

} 

이 구성자는 일반초기화코드를 포함하는 initO 함수를 호출한다 . 

LCDRange： : LCDRange( const char *s, QWidget *parent, const char 
*name ) 

: QVBox( parent, name ) 

{ 

initO; 

setText( s ); 

} 

이 구성자는 우선 initO 를 호출하고 표식자본문을 설정한다 . 
void LCDRange： : initO 
{ 

QLCDNumber *lcd = new QLCDNumber( 2, this, "led” ); 
slider = new QSlider( Horizontal, this, "slider" ) ； 
slider-〉setRange( 0, 99 ) ； 
slider->setValue ( 0 ) ； 
label = new QLabel( ” this, "label” ) ； 
label->setAlignment ( AlignCenter ) ； 
connect ( slider, SIGNAL (valueChanged (int)), 
led, SLOT (display (int)) ) ； 
connect ( slider, SIGNAL (valueChanged (int)), 

SIGNAL (valueChanged (int)) ) ； 


setFocusProxy( slider ) ； 

} 

led 와 slider 의 설정은 앞항에서와 같다 . 다음에 QLabel 을 창조하고 내용을 수직과 
수평으로 중심에 배치한다 . connect 0 문은 또한 앞의 소절로부터 취하였다 . 
const char *LCDRange： : textO const 
{ 

return label->text() ； 

} 

이 함수는 표식자본문을 돌려준다 . 
void LCDRange ： : setText( const char *s ) 

{ 

label->setText( s ) ； 

} 

이 함수는 표식 자본문을 설정한다 . 

③ tl2/cannon.h 

현재 CannonField 는 두개의 신호 hit () 와 missedO 를 가지며 목표를 포함한다 . 
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void newTarget 0 ； 

이 처리부는 새 위치에 목표를 창조한다. 
signals ： 
void hit() ； 
void missed () ； 

hit0 신호는 포탄이 목표를 맞힐 때 발생된다. missedO 신호는 포탄이 창문부품의 
오른변이나 밑변을 지나갈 때 발생된다. 

void paintTarget( QPainter * ) ； 

이 비 공개함수는 목표를 그린 다. 

QRect targetRectO const ； 

이 비 공개함수는 목표가 내 접 하는 직 4 각형 을 돌려 준다. 

QPoint target ； 

이 비공개변수는 목표의 중점을 포함한다. 

④ tl2/cannon.cpp 
#include <qdatetime.h> 

QDate, QTime 그리고 QDateTime 클라스정의들을 포함한다. 

#include <stdlib. h> 

randO 함수가 요구되므로 stdl 比)서고를 포함한다. 
newTargetO ； 

이 행을 구성자에 추가하여 목표의 우연적인 위치를 창조한다. 사실 newTargetO 
함수는 목표를 그리려고 한다. 구성자에 있으므로 CannonField 창문부품은 보이지 않 
는다. Qt 는 숨겨진 창문부품에 대하여 repaint 0 를 호출할 때 불필요한 작업이 진행되 
지 않도륵 한다. 

void CannonField： : newTargetO 
{ 

static bool first_time = TRUE ； 
if ( first_time ) { 
first_time = FALSE ； 

QTime midnight( 0, 0, 0 ) ； 

srand( midnight. secsTo (QTime :: currentTime ()) ) ； 

} 

QRegion r( targetRectO ) ； 

target = QPoint( 200 + randO % 190, 10 + randO % 255 ) ； 
repaint( r.unite( targetRectO ) ) ； 

} 

이 비공개 함수는 새 로운 우연위 치 에 목표중점을 창조한다 . 

randO 함수에 의 해 우연옹근수를 생성 한다. 보통 randO 함수는 프로그람을 실행할 
때마다 같은 계렬의 수를 돌려준다. 이것은 목표가 매번 같은 위치에 나타나게 한다. 이 
것을 피하기 위하여 함수가 처음으로 호출될 때 우연수종자 ( seed ) 를 설정해야 한다. 우 
연수종자도 역 시 갈은 우연수계 렬 을 피할수 있도륵 우연적 이 여 야 하므로 거 짓 우연수값으 
로서 자정으로부터 경과한 초수를 사용하는것 이 다. 

우선 정적인 bool 국부변수를 창조하여 함수호출들사이에서 값을 보관하도록 한다. 
if 시험은 if 블로크안에서 first _ time 을 FALSE 로 설정하였으므로 newTargetO 함수 
가 처음으로 호줄될 때만 성공한다. 

그다음 QTime 객 체 midnight 를 창조하고 시 간 00:00:00 을 표시한다. 다음에 자정 
으로부터 현재까지의 초수를 계산하여 우연수종자로 사용한다 (QDate, QTime, 
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QDateTime 참고). 

끝으로 목표의 중점 을 계 산한다. 중점 을 직 4각형 ( x =200, y =35, width =190, 
height =255) 안에서 유지하고(가능한 표와 y 값은 x = 200-389, y = 35〜 289) 자리표 
계에서 y 위치를 창문부품의 밑변에서 0으로 하고 우로 가면서 증가하게 하며 표는 보통 
과 같이 왼변을 0으로 하고 오른쪽으로 가면서 증가하게 한다. 

실험에 의하면 이것이 늘 포탄의 도달범위에 있다는것을 알수 있다. 
randO 는 0이상의 우연옹근수를 돌려준다. 
void CannonField ： ： moveShot () 

{ 

QRegion r ( shotRectO ) ； 
timerCount ++； 

QRect shotR = shotRectO ； 

시계사건의 이 부분은 변경하지 않았다. 
if ( shotR . intersects ( targetRectO ) ) { 
autoShootTimer -〉 stopO ； 
emit hitO ; 

if 문은 포탄직 4 각형 이 목표직4각형과 교차하는가 검사한다. 교차하면 포탄은 목표를 
맞힌다. 이때 사격시계를 정지하고 hit 0신호를 발생하여 외부세계에 목표가 파괴되였다 
고 알리고 되돌아간다. 

현지에 새 목표를 창조할수 있으나 CannonField 이 부분품이므로 이것은 사용자에 
게 맡긴다. 

} else if ( shotR . x () > width () || shotR . y () > height () ) { 
autoShootTimer -〉 stopO ; 
emit missed () ； 

이 if 문은 앞의 소절과 같지만 missedO 신호를 발생하여 외부세계에 실패를 알린다 
는것만 다르다. 

} else { 

그리고 함수의 나머지부분은 이전과 갈다. 

CannonField : : paintEvent 0는 이 전과 같지 만 다음것 을 추가한다. 
if ( updateR . intersects ( targetRectO ) ) 
paintTarget ( 技 p ) ； 

우의 두행은 필요할 때 목표를 그린다. 
void CannonField ： : paintTarget ( QPainter *p ) 

{ 

p->setBrush ( red ) ； 
p->setPen ( black ) ； 
p -> drawRect ( targetRectO ) ； 

} 

이 비 공개함수는 목표를 적 색 으로 칠 하고 흑색 륜곽선을 그린 다. 

QRect CannonField： : targetRectO const 

{ 

QRect r ( 0, 0, 20, 10 )； 

r . moveCenter ( QPoint ( target . x (), height () 一 1 - target . y ()) ) ； 
return r ； 
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이 비공개함수는 목표가 내 접하는 직 4각형 을 돌려 준다. newTargetO 에서 target 점 
은 창문부품의 밑변을 y 자리표 0으로 사용한다. QRect :: moveCenter () 를 호출하기전 
에 창문부품자리표로 점을 계산한다. 

이 자리표변환을 선택한 리유는 목표와 창문부품밑변사이의 거리를 고정하려는데 
있다. 창문부품의 크기는 임의의 시간에 사용자가 프로그람에 의해 조절할수 있다. 

⑤ tl 2/ main.cpp 

MyWidget 클라스에 새 로운 성 원은 없지 만 구성 자를 변경 하여 새 로운 LCDRange 
본문표식자를 설정한다. 

LCDRange *angle = new LCDRange ( " ANGLE ", this , " angle " ); 
angle 본문표식자를 ” ANGLE " 로 설정한다. 

LCDRange *force = new LCDRange ( " FORCE ", this , " force " ); 
force 본문표식자를 " FORCE ” 로 설정 한다. 

(2) 동작 

LCDRange 창문부품들은 좀 이상해보인다. QVBox 의 내부배치관리는 표식자들에 
더 많은 공간을 주며 나머지가 충분하지 않다. 다음 소절에서 그것을 고착시킨다. 

(3) 련습 

누를 때 포탄궤 도를 5 s 동안 현시 하는 거짓 ( cheat ) 단추를 CannonField 에 만드시 오. 
앞의 소절에서 《 둥근포탄》련습을 하였다면 shotRectO 를 QRegion 을 돌려주는 
shotRegionO 으로 변경하여 실제로 정확한 충돌탐색을 하도록 하시오. 

이동하는 목표를 만드시오. 

목표가 늘 화면우에 완전히 창조되는가 확신하시오. 

창문부품크기를 조절할수 없으므로 목표를 볼수 없다는것을 확인하시오. 암시: 
QWidget :: setMinimumSize 0 를 사용하시 오 . 

간단하지 않지만 공중에 여러개의 포탄이 동시에 있게 하시오. (암시 : Shot 객체를 만 

드시오.) 

13. 유희의 완료 

이 실례에서는 득점을 가지고 실제로 놀수 있는 유희로 만든다. MyWidget 에 새로 
운 이름 ( GameBoard ) 을 주고 일부 처리부들을 추가한다. 



그림 2-1 3. 유희의 완료 
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gamebrd.h 에 정의를， gamebrd.cpp 에 실현을 보관한다. 
그러면 CannonField 가 유희완료상태를 가전다. 
LCDRange 에서 배치문제들이 고착된다. 

• tl 3/ lcdrange.h 는 LCDRange 클라스를 정의 한다. 

• tl 3/ lcdrange.cpp 는 LCDRange 실현을 포함한다. 

• tl 3/ cannon.h 는 CannonField 클라스를 정의 한다. 

• tl 3/ cannon.cpp 는 CannonField 실현을 포함한다. 

• tl 3/ gamebrd.h 는 GameBoard 클라스를 정의 한다. 

• tl 3/ gamebrd.cpp 는 GameBoard 실현을 포함한다. 

• tl 3/ main.cpp 는 MyWidget 와 main 을 포함한다. 

(1) 명령문설명 

① tl 3/ lcdrange.h 
#include < qwidget . h > 


class QSlider ； 
class QLabel ； 


class LCDRange : public QWidget 

QVBox 보다도 QWidget 를 계승한다. QVBox 는 아주 사용하기 쉽지만 더 강력하 
고 복잡한 QVBoxLayout 로 절환된다. (QVBoxLayout 는 창문부품이 아니고 창문부 
품을 관리한다.) 

② tl3/lcdrange.cpp 
#include <qlayout.h> 

이제 qlayout.h 를 포함하여 다른 배 치관리 API 를 엄을수 있다. 

LCDRange ： : LCDRange( QWidget *parent, const char 

*name ) : QWidget( parent, name ) 

보통의 방법으로 QWidget 를 계승한다. 

다른 구성자는 같은 방법으로 변경한다. initO 는 변경되지 않지만 끝에 일부 행을 
추가한다. 

QVBoxLayout * 1 = new QVBoxLayout ( this ) ； 

모두 기정 값을 가지는 QVBoxLayout 를 창조하고 이 창문부품의 자식들을 관리 한다. 
l->addWidget( led, 1 ) ； 

꼭대기에 신축비가 0아닌 QLCDNumber 를 추가한다. 
l->addWidget( slider ) ； 
l->addWidget( label ); 

그다음 기정신축비 0을 가지는 두개 창문부품을 추가한다. 

이 신축조종은 QVBoxLayout 와 QHBoxLayout 및 QGridLayout) 에서 제공되고 
QVBox 와 같은 클라스에서는 제공되지 않는다. 이 경우에 QLCDNumber 가 신축되고 
다른것들은 신축되지 말아야 한다. 

③ tl3/cannon.h 

이제는 CannonField 가 유희완료상태와 일부 새로운 함수들을 가전다. 

bool gameOverO const { return gameEnded ； } 

이 함수는 유희가 완료하면 TRUE, 유희가 진행되고있으면 FALSE 를 돌려준다. 
void setGameOverO ； 
void restartGame 0 ； 
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여기에 두개의 새로운 처리부 setGameOverO 와 restartGameO 이 있다. 
void canShoot ( bool ) ； 

새 신호들은 CannonField 가 shootO 처리부가 의미를 가지는 상태에 있다는것을 
가리킨다. 다음에 그것을 사용하여 Shoot 단추를 허용, 금지 한다. 
bool gameEnded ； 

이 비공개변수는 유희의 상태를 포함한다. TRUE 는 유희가 끝났다는것을 의미하고 
FALSE 는 유희가 진행되고있다는것을 의미한다. 

④ tl 3/ cannon.cpp 
gameEnded = FALSE ; 

이 행을 구성 자에 추가하였다. 처음에 유희는 끝나지 않는다. 
void CannonField： : shootO 
{ 

if ( isShootingO ) 
return ； 

timerCount = 0； 
shoot_ang = ang ； 
shoot_f = f ； 

autoShootTimer->start ( 50 ) ； 
emit canShoot ( FALSE ) ； 

} 

새로운 isShootingO 함수를 추가함으로써 shootO 가 그것을 직접시험대신에 사용 
하게 한다. 또한 shoot 는 CannonField 가 지 금 사격 할수 없 다는것 을 알린 다. 
void CannonField： : setGameOverO 
{ 

if ( gameEnded ) 
return ； 

if ( isShootingO ) 
autoShootTimer -〉 stopO ； 
gameEnded = TRUE ； 
repaint () ； 

} 

이 처리부는 유희를 끝낸다. 이 창문부품이 유희완료시각을 모르므로 외부의 
CannonField 로부터 호출되여야 한다. 이것은 부분품프로그람작성에서 중요한 설계원 
칙이다. 부분품을 될수록 유연하게 하여 각이한 규칙들에서 사용할수 있게 한다. (실례 
로 여러선수 유희에서는 변경하지 않은 CannonField 를 사용할수 있다.) 

유희가 이미 끝났으면 즉시 되돌아간다. 유희가 진행되고있으면 포탄을 세우고 유 
희완료기발을 설정하고 전체 위체트를 다시 그린다. 
void CannonField ： : restartGameO 
{ 

if ( isShootingO ) 
autoShootTimer->stop () ； 
gameEnded = FALSE ； 
repaint () ； 

emit canShoot ( TRUE ); 

} 

이 처리부는 새로운 유희를 시작한다. 포탄이 공중에 있으면 사격을 중지한 다음 
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gameEnded 변수를 재설정하고 창문부품을 다시 그린다. 

moveShotO 도 역시 hit () 혹은 missO 와 같은 시간에 새로운 canShoot ( TRUE ) 
신호를 발생한다. 

CannonField :: paintEvent 0 에 서 의 수정 
void CannonField ： : paintEvent ( QPaintEvent *e ) 

{ 

QRect updateR = e->rectO ； 

QPainter p ( this ) ； 

if ( gameEnded ) { 
p . setPen ( black ) ； 

p . setFont ( QFont ( " Courier ", 48, QFont： : Bold ) ) ； 
p . drawText ( rectO , AlignCenter , "Game Over ” ) ； 

} 

그리기사건은 유희가 끝나면 즉 gameEnded 가 TRUE 이면 본문 ” Game Over ” 를 현 
시하도록 확장되였다. 유희가 끝날 때 속도는 중요하지 않다. 

우선 본문을 그리기 위하여 검은펜을 설정한다. 펜색은 본문을 그릴 때 사용된다. 
다음에 Courier 계렬에서 48 point 강조서체를 선택한다. 끝으로 창문부품의 직4각형중심 
에 본문을 그린다. 일부 체계(특히 유니코드서체를 가지는 X 봉사기들)에서 큰 서체를 
적재할수 있다. Qt 가 서체를 보관하므로 서체가 처음으로 사용될 때 이것을 통지한다. 
if ( updateR . intersects ( cannonRectO ) ) 
paintCannon ( 技 p ); 

if ( isShootingO 技技 updateR . intersects ( shotRectO ) ) 
paintShot ( &p ) ； 

if ( ! gameEnded 技技 updateR . intersects ( targetRectO ) ) 
paintTarget ( 技 p ) ； 

} 

사격할 때만 포탄을 그리고 유희할 때 (즉 유희가 끝나지 않았을 때)만 목표를 그린다. 
⑤ tl 3/ gamebrd.h 

이 파일은 새로운것이다. 이것은 GameBoard 클라스의 정의를 포함한다. 
class QPushButton ； 
class LCDRange ； 
class QLCDNumber ； 
class CannonField ； 

#include ’’ lcdrange . h ” 

#include " cannon , h " 


class GameBoard : public QWidget 

{ 

Q_OBJECT 

public ： 

GameBoard ( QWidget * parent =0, const char * name =0 ) ； 

protected slots ： 
void fireO ； 
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void hit() ； 
void missed () ； 
void newGameO ； 

private ： 

QLCDNumber *hits; 

QLCDNumber *shotsLeft ； 

CannonField *cannonField; 

}； 

현재 4 개 처리부를 추가하였다 . 이것들은 보호되고 내적으로 사용된다 . 또한 유희 
상태를 현시하는 두개의 QLCDNumber (hits 와 shotsLeft) 를 추가하였다 . 

⑥ tl3/gamebrd.cpp 

이 파일은 새로운것이다 . 이것은 마감에 GameBoard 클라스의 실현을 포함한다 . 

GameBoard 구성 자을 일부 변경 한다 . 
cannonField = new CannonField( this, "cannonField" ) ； 

지 금 cannonField 는 성 원변수이 므로 그것 을 사용하도록 구성 자를 조심 히 변경 한다 . 
connect ( cannonField, SIGNAL (hit 0), this, SLOT (hit ()) ); 
connect ( cannonField, SIGNAL (missed ()), this, SLOT (missed()) ) ； 

이번에는 처리부가 목표를 맞히거나 놓칠 때 어떤 일을 하기 위하여 CannonField 
의 hit () 와 missedO 신호를 이 클라스에서와 갈은 이름을 가지는 두개의 보호처리부와 
련결한다 . 

connect ( shoot, SIGNAL (clicked ()), SLOT (fire 0) )； 

이미 Shoot 단추의 clickedO 신호를 직접 CannonField 의 shootO 처리부에 련결 
하였다 . 이번에는 발사한 포탄수를 보관하여 이 클라스의 보호처리부에 련결하려고 한다 . 

자체 에 포함한 를포넨트들과 작업할 때 프로그람의 동작을 변경 하는것은 아주 간단 
하다 . 

connect ( cannonField, SIGNAL (canShoot (bool)), shoot, 
SLOT(setEnabled(bool)) )； 

또한 cannonField 의 canShoot0 신호를 리용하여 Shoot 단추를 적당히 허용하거 
나 금지한다 . 

QPushButton ^restart = new QPushButton( "&New Game", this, 
"newgame” ); 

restart->setFont( QFont( "Times", 18, QFont： : Bold ) ) ； 

connect ( restart, SIGNAL (clicked ()), this, SLOT (newGameO) ); 

다른 단추들에서 수행한것처럼 New Game 단추를 창조하고 설정하고 련결한다 . 이 
단추를 찰칵하면 이 창문부품에서 newGameO 처리부가 동작한다 . 
hits = new QLCDNumber( 2, this, "hits" ) ； 
shotsLeft = new QLCDNumber( 2, this, "shotsleft" ) ； 

QLabel *hitsL = new QLabeK ’’HITS”, this, M hitsLabel M )； 

QLabel *shotsLeftL= new QLabeK ’’SHOTS LEFT", this, 
’’shotsleftLabel” ) ； 

4 개의 새로운 창문부품을 창조한다 . GameBoard 클라스에서 QLabel 창문부품들의 
지적자를 사용할 필요가 없으므로 그것을 보관하지 않는다 . Qt 는 GameBoard 창문부품이 
해체될 때 그것들을 삭제하며 배치관리자클라스들은 그것들의 크기를 적당히 조절한다 . 
QHBoxLayout *topBox = new QHBoxLayout ； 


46 



grid - 〉 addLayout( topBox, 0, 1 )； 
topBox->addWidget ( shoot ) ； 
topBox->addWidget ( hits ) ； 
topBox->addWidget ( hitsL ) ； 
topBox - 〉 addWidget( shotsLeft ) ； 
topBox->addWidget ( shotsLeftL ) ； 
topBox->addStretch ( 1 ) ； 
topBox - 〉 addWidget( restart ) ； 

오른쪽 우에 있는 세포안의 창문부품수는 많다 . 그것이 비였으면 현재는 배치설정 
을 모두 묶어서 더 잘 개괄하는것이 좋다 . 

New Game 단추의 왼쪽에 범위를 넣을 대신에 모든 창문부품들이 자기가 좋아하는 
크기를 가지게 한다 . 
newGameO ； 

} 

GameBoard 를 모두 구성하였으므로 newGameO 에 의하여 그것을 기동한다 . 
(NewGameO 은 처리부이지만 일반함수처럼 사용될수도 있다 .) 
void GameBoard: : fire 0 
{ 

if ( cannonField -〉 gameOverO 11 cannonField->isShooting () ) 
return ； 

shotsLeft->display( shotsLeft->intValue() - 1 )； 
cannonField->shoot () ； 

} 

이 함수는 포탄을 발사한다 . 유희가 끝나거나 포탄이 공중에 있으면 즉시 되돌아간 
다 . 포탄수를 하나 감소하고 포를 발사하도록 한다 . 
void GameBoard :: hit () 

{ 

hits->display( hits->intValue() + 1 ) ； 
if ( shotsLeft->intValue() == 0 ) 
cannonField->setGameOver () ； 
else 

cannonField->newTarget () ； 

} 

이 처리부는 포탄이 목표를 맞힐 때 동작하며 명중회수를 증가시킨다 . 포탄이 없으 
면 유희는 끝나고 그렇지 않으면 CannonField 이 새로운 목표를 생성한다 . 
void GameBoard ： ： missed() 

{ 

if ( shotsLeft->intValue () == 0 ) 
cannonField->setGameOver () ； 

} 

이 처리부는 포탄이 목표를 놓쳤을 때 동작한다 . 포탄이 없으면 유희는 끝난다 . 
void GameBoard： : newGameO 
{ 

shotsLeft->display ( 15 ) ； 
hits -〉 display ( 0 ) ； 
cannonField -〉 restartGameO ； 
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cannonField->newT arget (); 

} 

이 처리부는 사용자가 Restart 단추를 찰칵할 때 동작한다 . 또한 구성자로부터도 
호출된다 . 우선 포탄수를 15 로 설정한다 . 이것은 포탄수를 설정하는 유일한 위치로서 
유희규칙을 변경하려고 할 때 변경한다 . 다음에 명중회수를 재설정하고 유희를 다시 시 
작하고 새 목표를 생성한다 . 

■⑦ tl3/main.cpp 

창문부품을 작성하였으며 이제 유일하게 남은것은 mainO 함수이다 . 

(2) 동작 

포는 목표에 발사할수 있고 목표를 맞힐 때 새 목표가 자동적으로 창조된다 . 

명중회수와 나머지 포탄이 현시되고 프로그람은 그것을 보관한다 . 유희를 끝내고 
새 유희를 시작하는 단추가 있다 . 

(3) 련습 

우연적 인 바람결수를 추가하고 그것을 사용자에게 보여주시오 . 

포탄이 목표를 맞힐 때 산탄효과를 만드시오 . 

여러 목표를 실현하시오 . 

14. 방탄벽을 쌓기 

이것은 마지막 실례 즉 완성된 유희이다 . 

건반지름건을 추가하고 CannonField 에 마우스사건들을 받아들인다 . 

CannonField 주위에 틀을 넣고 방탄벽을 추가하여 유희를 더 재미있게 만든다 . 



그림 2-1 4. 방탄벽쌀기 

• 比 4/lcdrange. h 는 LCDRange 클라스를 정의 한다 . 

• tl4/lcdrange.cpp 는 LCDRange 를 실현한다 . 

• tl4/cannon.h 는 CannonField 들라스를 정의 한다 . 

• tl4/cannon.cpp 는 CannonField 를 실현한다 . 

• tl4/gamebrd.h 는 GameBoard 를라스를 정의 한다 . 

• 1 14 / gamebrd. cpp 는 GameBoard 를 실현 한다 . 
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• tl4/main.cpp 는 MyWidget 와 main 을 포함한다 . 

(1) 명령문설명 

① tl4/cannon.h 

지금 CannonField 는 마우스사건들을 받아들이고 사용자가 방탄벽우를 찰칵하고 
끌어서 방탄벽을 겨눌수 있다 . 또한 CannonField 는 방탄벽을 가전다 . 
protected ： 

void paintEvent( QPaintEvent * ); 
void mousePressEvent ( QMouseEvent * ) ； 
void mouseMoveEvent ( QMouseEvent * ); 
void mouseReleaseEvent ( QMouseEvent * ); 

이미 친숙해진 사건처리함수들과 함께 CannonField 는 마우스사건처리함수들을 실 
현한다 . 

void paintBarrier( QPainter * ) ； 

이 비 공개함수는 방탄벽 을 그린 다 . 

QRect barrierRectO const； 

이 비 공개함수는 방탄벽 이 내 접 하는 직 4 각형 을 돌려 준다 . 

bool barrelHit( const QPoint 技 ) const； 

이 비공개함수는 점 이 포의 방탄벽안에 있는가 검사한다 . 
bool barrel Pressed ； 

이 비공개변수는 사용자가 방탄벽우에서 마우스를 누른 상태에서 놓지 않았을 때 
TRUE 이다 . 

② tl4/cannon.cpp 
barrel Pressed = FALSE ； 

이 행을 구성자에 추가하였다 . 처음에 마우스는 방탄벽우에서 눌러우지 않는다 . 

} else if ( shotR.xO > width() || shotR.yO > height() || 
shotR. intersects (barrierRectO) ) { 

이제는 방탄벽이 있지만 세가지 빠뜨린것이 있다 . 세번째로 시험한다 . 
void CannonField： : mouseP ressE vent ( QMouseEvent *e ) 

{ 

if ( e->button() != LeftButton ) 
return ； 

if ( barrelHit( e->pos () ) ) 
barrelPressed = TRUE； 

} 

이것은 Qt 사건처 리 함수이다 . 이것은 마우스유표가 창문부품우에 있고 사용자가 마 
우스단추를 누르는 경우에 호출된다 . 

사건이 왼쪽마우스단추에 의해 생성되지 않았으면 즉시 되돌아간다 . 그렇지 않으면 
마우스유표의 위치가 포의 방탄벽안에 있는가 검사하고 있으면 barrelPressed 를 TRUE 로 
설정 한다 . 

pos() 함수는 창문부품자리표계 의 점 을 돌려준다 . 
void CannonField： : mouseMoveEvent( QMouseEvent *e ) 

{ 

if ( ! barrel Pressed ) 
return ； 

QPoint pnt = e->pos () ； 
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if ( pnt.xO <= 0 ) 
pnt. setX( 1 ); 
if ( pnt.yO >=■ height () ) 
pnt. setY( height 0 - 1 ) ； 

double rad = atan(((double)rectO.bottomO-pnt.y0)/pnt.x0); 
set Angle ( qRound ( rad*180/3.14159265 ) ); 

} 

이것은 또 하나의 Qt 사건처리함수로서 사용자가 창문부품안에서 이미 마우스단추를 
누르고 마우스를 이동하거나 끌기했을 때 호출된다. (단추들을 누르지 않을 때도 Qt 가 
마우스이 동사건들을 보내 게 할수 있 다. QWidget :: setMouseTracking() 참고. ) 

이 처리함수는 마우스유표의 위치에 따라서 포의 방탄벽을 재배치한다. 

우선 방탄벽을 누르지 않으면 되돌아간다. 다음으로 마우스유표의 위치를 계산한다. 
마우스유표가 창문부품의 왼쪽이나 아래에 있으면 점이 창문부품안에 놓이도록 조절한다. 

그다 음 창문부품의 왼쪽아래구석과 유표위 치사이의 가상선과 창문부품밑변사이의 
각을 계산한다. 끝으로 포의 각도를 도로 변환한 새 값으로 설정한다. 
set Angle 0는 포를 다시 그린다. 

void CannonField： : mouseReleaseEvent( QMouseEvent *e ) 

{ 

if ( e->button () 싹 LeftButton ) 
barrelPressed = FALSE ； 

} 

이 Qt 사건처리함수는 사용자가 창문부품안에서 눌렀던 마우스단추를 놓을 때마다 
호출된 다. 

왼쪽단추를 놓으면 방탄벽을 더는 누르지 않는다는것을 확인할수 있다. 

그리기사건은 두개의 행을 추가적으로 가진다. 즉 
if ( updateR. intersects ( barrierRectO ) ) 
paintBarrierC &p ); 

paintBarrierO 는 paintShotO, paintTargetO, paintCannon0 와 같은 일을 수 
행 한다. 

void CannonField： : paintBarrierC QPainter *p ) 

{ 

p->setBrush( yellow ); 
p->setPen ( black ); 
p- 〉 drawRect( barrierRectO ); 

} 

이 비공개함수는 방탄벽을 황색으로 도색하고 검은색륜곽선을 가지는 직4각형으로 
그린다. 

QRect CannonField： : barrierRectO const 

{ 

return QRect( 145, height() - 100, 15, 100 ) ； 

} 

이 비 공개함수는 방탄벽 의 직 4각형 을 돌려 준다. 방탄벽 의 밑 변을 창문부품의 밑 변 
으로 고정한다. 

bool CannonField ： : barrelHit( const QPoint &p ) const 


QWMatrix mtx ； 
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mtx . translate ( 0 ， height () - 1 ) ； 
mtx . rotate ( -ang ); 
mtx = mtx . invert () : 

return barrelRect . contains ( mtx . map ( p ) ); 

} 

이 함수는 점이 방탄벽안에 있으면 TRUE , 그렇지 않으면 FALSE 를 돌려준다. 

여기서는 콜라스 QWMatrix 를 사용한다. 이것은 qpainter . h 에 의하여 포함되는 
머리부파일 qwmatrix . h 에서 정의된다. 

QWMatrix 는 자리표계변환을 정의하며 QPainter 와 같은 변환을 수행한다. 

여기서는 paintCannonO 함수에서 방탄벽을 그릴 때 수행한것과 같은 변환단계들 
을 수행한다. 우선 자리표계를 변환하고 그것을 회전한다. 

이제는 점 p (창문부품자리표)가 방탄벽안에 놓이는가 검사하여야 한다. 그러기 위하여 
변환행렬을 역전시킨다. 역행렬은 방탄벽을 그릴 때 사용하는 역변환을 수행한다. 역행렬 
을 리 용하여 점 p 를넘기고 그것 이 원시 방탄벽 직4각형안에 있으면 TRUE 를 돌려준다. 

③ tl 4/ gamebrd . cpp 
#include < qaccel . h > 

QAccel 의 콜라스를 정의한다. 

QVBox *box = new QVBox ( this , " cannonFrame " ); 
box -> setFrameStyle ( QFrame ： : WinPanel | QFrame ： ： Sunken )； 
cannonField = new CannonField ( box , " cannonField " ); 

QVBox 를 창조하고 설정하며 그 틀형식을 설정한 다음 그 칸의 자식으로서 
CannonField 를 창조한다. 그밖에 칸안에 아무것도 없으므로 QVBox 는 CannonField 주 
위에 틀을 넣은 효과가 나타난다. 

QAccel *accel = new QAccel ( this )' i 


acce 卜〉 connectltem ( 
SLOT ( fireO ) )； 

accel->insertltem ( 

Key_Enter 

), 

this , 

acce 卜〉 connectltem ( 
SLOT ( fireO ) )； 

acce 卜〉 insertltem ( 

Key_Return 

), 

this , 


여기서는 지름건을 창조하고 설정한다. 지름건은 건반사건들을 응용프로그람에 받 
아들이고 주어진 건들을 누르면 처리부들을 호출하는 객체이다. 지름건은 창문부품의 자 
식이며 창문부품이 해체될 때 같이 해체된다. QAccel 은 창문부품이 아니고 그 부모에 
서 효과를 볼수 없다. 

두개의 지름건을 정의한다. 사용자가 Enter 를 누를 때 처리부 fire () 가 호출되게 
하고 건 Ctrl + Q 를 누를 때 응용프로그람을 중지한다. 흔히 Enter 는 Return 이고 두개 
의 건이 다 있는 건반도 있으므로 Enter 와 Return 이 모두 fireO 를 호출하게 한다. 

accel-〉connectItem ( accel->insertltem ( CTRL + Key_Q ), qApp , 

SLOT (quit 0) )； 

그다음 Ctrl + Q 를 설정하여 Alt + Q 와 같은 일을 수행한다. 일부 사람들은 Ctrl + Q 를 
더 사용한다. 

CTRL , Key _ Enter , Key _ Return , Key _ Q 는 모두 Qti 의해 제공되는 상수들이며 
실제로 Qt ： : Key_Enter 등과 갈지만 모든 클라스들은 Qt 이름공간들라스를 계승한다. 
QGridLayout *grid = new QGridLayout ( this , 2, 2, 10 ); 
grid -> addWidget ( quit , 0,0 )； 
grid -> addWidget ( box , 1, 1 ); 
grid->setColStretch ( 1, 10 ); 
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오른쪽 아래 세포에 CannonField 가 아니 라 box ( QVBox ) 를 넣 는다. 

(2) 동작 

현재 포는 Enter 를 누르면 발사된다. 또한 마우스를 사용하여 포의 사각을 지정할 
수 있다. 방탄벽은 유희를 좀 더 재미있게 놀수 있게 한다. 또한 CannonField 둘레에 
아름다운 틀이 있다. 

(3) 련습 

공중비적유희를 쓰시오. 

파편 ( Breakout ) 유희를 쓰시오. 

제3절. 도표의 작성 

이 절에서는 2절보다 현실에 더 가까운 Qt 프로그람작성 실례를 제 시한다. 여 기서는 
차림표(최근파일목록 포함)，도구띠, 대화칸의 창조, 사용자환경설정의 적재와 보관 등 
Qt 프로그람작성 의 많은수법 들을 소개한다. 

여기서는 사용자가 입력하는 자료에 기초하여 간단한 원형도표와 막대도표를 현시 
하는데 사용되는 chart 라는 하나의 응용프로그람을 개 발한다. 

응용프로그람의 개발을 설명하고 코드부분에 대하여 설명한다. 응용프로그람의 완 
성된 원천은 examples/chart 에 있 다. 

j -w |3!日 • □ x 

Eile Options Help 

函 환關 





그림 2-15. 도표프로그람의 실행화면 
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1. 도표프로그람의 구성 



그림 2-1 6. 도표프로그람의 구성 


chart 프로그람은 사용자가 단순자료모임을 창조하고 보관하고 적재하고 표시한다. 
사용자가 입력하는 매개 자료요소는 부채형이나 막대, 표식자본문，본문의 위치와 색으 
로 주어질수 있다. Element 콜라스는 자료요소들을 재현하는데 쓰인다. 

프로그람은 도표폼을 적재하는 단순한 main . cpp 로 구성된다. 도표픔은 프로그람의 
기능호출을 제공하는 차림표띠와 도구띠를 가진다. 프로그람은 두개의 대화칸 즉 하나는 
선택대화칸, 다른 하나는 자료모임을 창조하고 편집하기 위한 대화칸을 제공한다. 두 대 
화칸은 도표로부터 차림 표선택 이 나 도구띠단추를 통하여 펼 쳐 진다. 

도표좀의 기본창문부품은 원형도표나 막대그라프를 그리는 QCanvas 를 현시하는 
QCanvasView 이다. QCanvas View 의 파생 콜라스를 만들어 구체적인 동작을 얻 는다. 
마찬가지로 표준콜라스가 제공하는것보다 훨씬 더 많은것을 요구하므로 QCanvasText 
의 파생 콜라스를 만든다. (캔버 스에 본문항목들을 배 치 하는데 쓰인다. ) 

프로젝트파일 chart , pro 는 응용프로그람을 구축하는데 쓰이는 Makefile 의 창조에 
사용된다. 


2. 자료요소 

Element 라는 C ++ 콜라스를 호출하여 자료요소들의 기억과 호출을 제공한다. 

// element , h 로부터 발취 
private ： 

double m _ value ； 

QColor m _ valueColor ； 
int m _ valuePattern : 

QString m _ label : 

QColor m _ labelColor ； 

double m_propoints [2 * MAX _ PROPOINTS ] : 

매개 요소는 값을 가전다. 매개 값은 특정한 색과 채우기패턴으로 그라프적으로 현 
시된다. 값들은 그것들과 련관된 표식 자를 가질수 있으며 표식자는 표식 자색 으로 그려지 
고 매개 형의 도표에 대하여 m _ propoints 배렬에 보관된 상대위치를 가전다. 
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#include < qcolor . h > 

#include < qnamespace . h > 

#include < qstring . h > 

#include < qvaluevector . h > 

Element 클라스가 순수 내부적 인 자료콜라스타고 할지 라도 4개의 Qt 들라스들을 포 
함한다. Qt 는 흔히 순수 GUI 도구일식 으로서 알고있지만 그밖에도 수많은 비 GUI 콜라스 
들을 제공하여 응용프로그람작성의 대부분의 측면들을 유지한다. qcolar.h 를 사용하여 
Element 콜라스에 그리기색과 본문색을 보관할수 있다. qnamespace.h 의 사용은 명백 
하다. 대부분의 Qt 콜라스는 각종 렬거형을 포함하는 Qt 기초클라스로부터 파생된다. 
Element 콜라스는 Qt 로부터 파생되지 않으므로 qnamespace.h 를 포함하여 Qt 렬거 이름 
들을 호출할수 있게 한다. 다른 수법은 Element 를 Qt 파생들라스로 만드는것이다. 
qstring.h 를 포함하여 Qt 의 유니코드문자렬들을 사용하게 한다. 편리하게 Elements 용 
의 벡 토르용기를 형정의 하여 qvaluevector . h 머 리 부파일에 넣 는다. 
typedef QValueVector < Element > ElementVector ； 

Qt 는 수많은 용기를 제공하는데 일부는 QValueVector 와 같이 값에 기초하고 다 
른 일부는 지적자에 기초한다(집합클라스참고). 여기서는 하나의 용기를 형정의하고 하 
나의 ElementVector 에 매개 자료모임을 보관한다. 

const double EPSILON = 0.0000001； // Must be > INVALID . 

요소들은 정의 값만 가질수 있다. 값을 double 로 보관하므로 0과 쉽게 비교할수 
있다. 대신에 령 에 가까운 값 EPSILON 을 지정하고 EPSILON 보다 큰 값을 정의 유효 
값으로 고찰한다. 

class Element 

{ 

public ： 

enum { INVALID = -1 }; 

enum { NO_PROPORTION = -1 } ； 

enum { MAX_PROPOINTS = 3 }; // One proportional point per chart 

type 

Element 용으로 3 개의 공개렬거형을 정의한다. INVALID 는 isValidO 함수에서 사 
용한다. Element 들의 고정크기벡토르를 사용하며 그것들에 INVALID 값들을 줌으로써 
사용하지 않은 Element 들을 표식 하는데 쓸수 있 다. NO_PROPORTION 렬 거 는 사용자 
가 Element 의 표식자를 배치하지 않았다는것을 지정하는데 쓰이며 임의의 정의 비률값 
은 본문요소의 위치가 캔버스의 크기에 비례하게 취해진다. 

매 개 표식자의 X， y 위 치를 보관하였으면 사용자가 기본창문(캔버스)의 크기를 조절 
할 때마다 본문은 그의 원시(현재 정 확하지 않은)위 치를 기 억하군 한다. 그러므로 절대 
( x , y ) 위치를 보관할 대신에 비례위치 즉 x 八 vidth 와 y 入 height 를 보관한다. 본문을 
그리려고 할 때 이 위치들에 현재 폭과 높이를 각각 곱할수 있으며 본문은 크기조절에 
관계없이 정확히 위치된다. 실례로 표식자가 x 위치 300를 가지고 캔버스가 400화소폭 
을 가지면 x 값의 비례는 300/400 = 0.75 이다. 

렬거값 MAX_PROPOINTS 에는 문제가 있다. 매개 도표형에 대하여 본문표식자의 
표와 y 비례를 보관하고 고정크기배렬로 이 비례들을 보관하기로 한다. 그러므로 필요한 
비례쌍들의 최대수를 지정해 야 한다. 이 값은 도표형의 수에 따라 다르며 이것은 
Element 콜라스가 CMrtForm 콜라스에 의해 제공된 도표형의 수와 완전히 련관된다는 
것을 의미한다.큰 응용프로그람에서는 점들을 보관하는데 백토르를 사용하며 몇개의 도 
표형을 사용하는가에 따라서 크기를 동적으로 조절할수 있다. 
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Element ( double value = INVALID, QColor valueColor = Qt ： ： gray, 
int valuePattern = Qt: : 名 olidPa 竹 ern, const QStringS label = 
QString ： ： null, 

QColor labelColor = Qt ： ：black ) { 
init( value, valueColor, valuePattern, label, labelColor ) : 
for ( int i = 0； i < MAX_PROPOINTS * 2; ++i ) 
m_propoints [i] = NO_PROPORTION ； 

} 

구성 자는 Element 클라스의 모든 성 원들에 대 한 기 정값을 제 공한다. 새 요소들은 항 
상 위 치를 가지지 않는다는 표식을 가진다. 구성자처 럼 동작하는 set 0 함수를 제공하므 
로 initO 함수를 사용한다. 

bool isValidO const { return m—value > EPSILON ； } 

고정 크기 벡 토르에 Element 들을 보관하므로 특정 한 요소가 유효한가를 검 사할수 있 어 
야 한다. 즉 계산에 사용되고 현시되여야 한다. 이것은 isValidO 함수에 의해 간단히 달 
성된 다. 

// element.cpp 로부터 발취 
double Element ： : proX( int index ) const 
{ 

Q_ASSERT (index >= 0 && index < MAX_PROPOINTS); 
return m_propoints [2 * index] : 

} 

얻기함수와 설정함수들이 Element 의 모든 성원들에 제공된다. proXO 와 proYO 얻 
기함수들과 setProXO 와 setProYO 설정함수들은 비례위치를 적용하는 도표의 형을 식 
별하는 첨수를 가진다. 이것은 사용자가 갈은 자료모임에 대하여 수직막대도표, 수평막 
대도표 및 원도표에 대하여 따로따로 위치지정된 표식자들을 가질수 있다는것을 의미한 
다. 또한 Q_ASSERT 마크로를 사용하여 도표형첨 수에 대 한 사전조건검 사를 제 공한다 (4 장 
4절 참고). 

- 자료요소의 읽기와 쓰기 

// element.h 에서 발취 

QTextStream & operator «( QTextStream &, const Elements ); 
QTextStream & operator »( QTextStreamS , Elements ); 

Element 클라스를 더 완성 하기 위 하여 <<와 >>연산자들을 재정의 함으로써 Element 들 
을 본문흐름에 대하여 읽고쓸수 있도록 한다. 간단히 2진스트림을 사용할수 있지만 본 
문을 사용함으로써 사용자들이 본문편집 기 에서 자료를 조작하고 스크립 트언어 에 의하여 
자료를 쉽게 생성 하고 려과할수 있게 한다. 

// element.cpp 에서 발취 
#include "element.h" 

#include <qstringlist. h> 

#include <qtextstream. h> 

연산자들의 실현은 qtextstream.h 와 qstringlist.h 를 포함할것을 요구한다. 
const char FIELD_SEP = ’: ; 
const char PROPOINT_SEP = ’; ’; 
const char XY—SEP = ’, ’; 

자료를 보관하는더 1 사용하는 형식은 마당들을 반점으로 구분하고 레코드들을 새행 
으로 구분한다. 비 례점들은 반두점 으로 구분하고 x, y 쌍은 점 으로 구분한다. 마당순서 
는 값, 값의 색 , 값패 턴，표식 자의 색，표식 자의 점들，표식 자본문이다. 실례 로 
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20 ： #ffOOOO ： 14 ： #000000 ： 0. 767033,0.412946 ； 0,0.75 ； 0,0：Red : with colons：! 
70 ： #00ffff ： 2 ： #ffff00 ： 0.450549,0.198661 ； 0.198516,0.125954 ； 0,0.198473：Cyan 
35 ： #0000ff ： 8 ： #555500 ： 0.10989,0.299107 ； 0.397032,0.562977 ； 0,0.396947：Blue 
55 ： #ffff00 ： l ： #000080 ： 0.0989011,0.625 ； 0.595547,0.312977 ； 0,0.59542：Yellow 
80 : #ff00ff: 1 : #000000 : 0.518681,0.694196;0.794063,0;0,0.793893 : Magenta or Violet 
Element 자료를 읽어 들이 는 방법 으로 인하여 표식 자본문에 서 나타나는 공백 과 마당분 
리기호들과 관련한 문제는 없다. 

QTextStream &operator«( QTextStream 技 s, const Element 技 element ) 

{ 

s « element, value() << FIELD_SEP 
« element.valueColorO.name0 « FIELD_SEP 
« element. valuePatternO << FIELD_SEP 
« element. labelColorO. nameO « FIELD_SEP ； 


for ( int i = 0； i < Element ： : MAX_PROPOINTS ； ++i ) { 
s << element. proX( i ) « XY—SEP << element. proY( i ) ； 
s « ( i == Element ： : MAX_PROPOINTS - 1 ? FIELD_SEP 

PROPOINT_SEP )； 


s « element , label () « ’\ n ’; 
return s ； 

} 

요소들을 쓰는 방법은 간단하다. 매개 성원의 뒤에 마당구분기호가 따른다. 점들은 
x, y 쌍들을 반점 (XY_SEP) 으로 구분하며 매 개 쌍은 PROPOINT_SEP 구분기 호에 의 해 구 
분된다. 마지막 마당은 표식이고 그 뒤에 새행이 따른다. 

QTextStream 技 operator 〉〉( QTextStream 技 s , Element 技 element ) 

{ 

QString data = s . readLineO ； 
element. setV alue( Element: : INVALID ); 

int errors = 0; 
bool ok; 

QStringList fields = QStringList::split( FIELD SEP, data ); 
if (fields.count() >=4 ) { 
double value = fields[0] .toDouble( &ok); 
if(!ok) 
errors++; 

QColor valueColor = QColor( fields[l]); 
if ( !valueColor.isValid()) 
errors++; 

int valuePattem = fields[2].toInt( &ok); 
if(!ok) 
errors++; 

QColor labelColor = QColor( fields[3]); 
if(!labelColor.isValid()) 
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errors++; 

QStringList propoints = QStringList::split( PROPOINT SEP, fields[4] ); 
QString label = data.section( FIELD SEP, 5 ); 


if ( ! errors) { 

element.set( value, valueColor, valuePattem, label, labelColor); 
int i = 0; 

for ( QStringList: : iterator point = propoints.begin(); 
i < Element: : MAX PROPOINTS && point != propoints.end(); 

++i, ++point) { 
errors = 0; 

QStringList xy = QStringList::split( XY_SEP, *point); 
double x = xy[0].toDouble( &ok); 
if(!ok||x<=0.0||x>=1.0) 
errors++; 

double y = xy[l].toDouble( &ok); 
if(!ok||y<=0.0||y>=1.0) 
errors++; 
if ( errors) 

x = y = Element: :NO_PROPORTION; 
element.setProX( i, x); 
element. setProY( i, y); 

} ' 

} 

} 

return s; 

} 

요소들을 읽어 들이기 위하여 한개 레 코드(즉 한 행 ) 를 읽 는다. 
QStringList :: split 0에 의해 자료를 마당들로 분해한다. 표식이 FIELD_SEP 문자들을 
포함할수 있으므로 QString :: section 0에 의해 마지막 마당으로부터 행는까지의 모든 
본문을 꺼 낸 다. 충분한 마당이 있 고 값，색 , 패 턴자료가 유효하면 Element :: set() 에 의하 
여 이 자료를 요소에 써넣고 그렇지 않으면 요소를 INVALID 로 한다. 그다음 점들을 순 
환한다. 표와 y 비례는 요소에 대하여 설정된 범위에 있다. 하나 혹은 두 비례가 무효이 
면 값을 0으로 보관하는데 이것은 무효한 (그리 고 범위밖의) 비 례 점값들을 
NO_PROPORTION 으로 변경 하므로 적 합하지 않다. 

현재 Element 콜라스는 요소자료들을 보관하고 조작하고 읽 고 쓰는데 충분하지 못하다. 또 
한 요소집 합을 보관하기 위 한 요소벡 토르형 정 의 도 창조하였 다. 

이제는 main.cpp 와 사용자들이 자료모임을 창조하고 편집하고 볼수 있는 사용자대면 
부를 만들 준비가 되였다. 

3. 주로 간단하게 

/ / main.cpp 

#include < qapplication . h > 

#include " chartform . h " 


int main ( int argc , char *argv [] ) 

{ 

QApplication app ( argc , argv ); 
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QString filename ； 
if ( app.argcO > 1 ) { 
filename = app.argvO [1] ； 
if ( ! filename . endsWith ( ". cht " ) ) 
filename = QString ： : null ； 

} 

ChartForm *cf = new ChartForm ( filename ); 
app . setMainWidget ( cf ); 
cf -> show () : 

return app . exec () : 

} 

main 0 함수를 간단하고 작게 만든다. QApplication 객체를 창조하고 거기에 지령 
행 인수들을 넘긴다. 사용자가 도표 mychartcht 를 가지고 프로그람을 호출하게 하여 파일 
이 름이 추가되 면 그것 을 도표종구성자를 통하여 넘 기 도록 한다. 대 부분의 작용은 다음에 
고찰하는 도표폼에 배 치한다. 

4. GUI 를 현시하기 



그림 2-17. G 내의 현시 

chart 응용프로그람은 중심창문부품 즉 편리한 문서중심형식의 Canvas View 에 배 
치 된 차림 표와 도구띠단추들을 통하여 항목들에 대 한 호출을 제 공한다. 

// chartform . h 에서 발취 
class ChartForm ： public QMainWindow 
! 

Q_OBJECT 

public ： 

enum { MAX_ELEMENTS = 100 } ； 

enum { MAX—RECENTFILES = 9 }; // Must not exceed 9 
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enum ChartType { PIE, VERTICAL_BAR, HORIZONTAL_BAR }； 
enum AddValuesType { NO, YES, AS.PERCENTAGE }; 

ChartForm( const QString 技 filename ) ； 

〜 ChartFormO; 


int chartType () { return m_chartType ； } 

void setChanged( bool changed = TRUE ) { m_changed = changed ； } 
void drawElementsO ； 

QPopupMenu *optionsMenu ； // public 로 하는 근거는 canvas view, cpp 
를 보시오. 


protected ： 

virtual void closeEvent ( QCloseEvent * ) ； 

private slots ： 
void fileNewO ; 
void fileOpenO ； 

void fileOpenRecent ( int index ) ； 

void fileSaveO ； 

void fileSaveAsO ； 

void fileSaveAsPixmapO ； 

void filePrintO ； 

void fileQuitO ； 

void optionsSetDataO ； 

void updateChartType ( QAction *action ) ； 

void optionsSetFontO ； 

void optionsSetOptions 0 ； 

void helpHelpO ； 

void helpAboutO ； 

void helpAboutQtO ； 

void saveOptionsO ； 

private ： 
void initO ; 

void load ( const QString & filename ) ； 
bool okToClearO ； 

void drawPieChart ( const double scales [], double total , 
int count ) ； 

void drawVerticalBarChart ( const double scales [], double total , 
int count ) ； 

void drawHorizontalBarChart ( const double scales [], double total , 
int count ) ； 


QString valueLabeK const QString 技 label, double value, 
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double total ) ； 

void updateRecentFiles ( const QString 技 filename ); 

void updateRecentFilesMenuO ； 

void setChartType ( ChartType chartType ) ； 

QPopupMenu * fileMenu ; 

QAction *optionsPieChartAction ； 

QAction *optionsHorizontalBarChartAction ； 

QAction * optionsVerticalBarChartAction ; 

QString m_filename ； 

QStringList m _ recentFiles ； 

QCanvas * m _ canvas ; 

CanvasView * m_canvasView ； 
bool m _ changed ； 

ElementVector m_elements ； 

QPrinter * m _ printer ; 

ChartType m _ chartType ； 

AddValuesType m _ addValues ； 
int m _ decimalPlaces ； 

QFont m_font ； 

}； 

QMainWindow 의 파생클라스 ChartForm 를 창조한다. 이 파생클라스는 

Q _ OBJECT 마크로를 사용하여 Qt 의 신호-처 리 부기 구를 유지한다. 

공개대면부는 아주 작고 현시하고있는 도표형을 얻고 도표는〈〈변경된것〉〉으로 표 
시하고(완료할 때 사용자에게 보관하겠는가를 묻는다.) 도표자체를 그리겠는가 
( drawElementsO ) 하는 물음을 얻을수 있다. 또한 선택 ( option ) 차림표를 캔버스보기 
의 상황차림표로 사용하므로 이 차림표를 공개로 만든다. 


QCanvas 클라스는 2차원벡토르도형을 그리는데 사용된다. QCanvasView 
클라스는 응용프로그람의 GUI 에서 캔버스의 보기를 현시하는데 쓰인다. 모든 그 
리기조작은 캔버스우에서 수행되지만 사건들(실례로 마우스찰칵)은 캔버스보기에 

서 발생한다. _ 

매개 작용은 비공개처리부에 의해 표시된다. 실례로 fileNewO , 
optionsSetDataO 등이 다. 또한 아주 많은 비 공개함수와 자료성 원들이 있 다. 

편리성과 를파일의 속도를 높이기 위하여 도표픔의 실현을 세개 파일 즉 GUI 용의 
chartform . cpp , 캔버스조종용의 chartform _ canvas . cpp 그리고 파일 조종용의 
chartform _ files . cpp 로 분리 한다. 

(1) 도표픔 GUI 

// chartform.cpp 에서 발취 
#include M images / file _ new . xpm " 

#include " images / file _ open . xpm ” 

#include " images / options _ piechart . xpm ” 
chart 에서 사용한 모든 화상들은 images 보조등록부에 배치되는 . xpm 파일들로 창조된다. 

(2) 구성 자 ^ 

ChartForm ： : ChartForm ( const QString 技 filename ) 

: QMainWindow ( 0，0, WDestructiveClose ) 
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QAction * fileNewAction ; 

QAction * fileOpenAction : 

QAction * fileSaveAction : 

매개의 사용자작용에 대하여 QAction 지적자를 선언한다. 일부 작용은 구성자의 밖 
에서 참고되 여 야 하므로 머 리부파일에서 선언된다. 


대부분의 사용자작용은 차림표항목과 도구띠단추들로서 모두 적합하다. 
Qt 는 차림표와 도구띠에 모두 추가할수 있는 하나의 QAction 을 창조한다. 이 
수법은 차림표항목과 도구띠단추들을 동기시키고 반복코드를 줄일수 있도록 
한다._ 


fileNewAction = new QAction ("New Chart ", QPixmap ( file_new ), 
"& New ", CTRL + Key _ N , this , " new " )； 
connect ( fileNew Action , SIGNAL ( activated 0 ), this , 

SLOT ( fileNew 0 ) )； 

작용을 구성할 때 거기에 이름과 선택적인 그림기호，차림표본문，지름건을 준다. 
지름건이 요구되지 않으면 0을 준다. 또한 this 를 넘기여 그것을 폼의 자식으로 만든다. 
사용자가 도구띠단추를 찰칵하거 나 차림 표항목을 찰칵할 때 activated () 신호가 발생 된다. 
이 신호를 작용의 처리부(우의 코드에서 fileNewO ) 에 connectO 한다. 

도표형들은 모두 배타적이고 원형도표 혹은 수직막대도표 혹은 수평막대도표를 하 
나 가질수 있다. 이것은 사용자가 원도표의 차림표항목을 선택하면 원도표의 도구띠단추 
도 자동적 으로 선택 되 고 다른 도표의 차림 표항목들과 도구띠단추들의 선택 은 자동적 으로 
해제되여야 한다는것을 의미한다. 이 동작은 QActionGroup 을 창조하고 도표형의 작용 
들을 그를안에 배치하여 엄는다. 

QActionGroup *chartGroup = new QActionGroup ( this ); 

// Connected later 
chartGroup -> setExclusive ( TRUE ); 

작용그롭은 좀 ( this ) 의 자식 으로 되 고 배 타적 인 동작은 setExclusive () 호출에 의 해 얻 는다. 
optionsPieChartAction = new QAction ( 

"Pie Chart ", QPixmap ( options_piechart )， 

"&Pie Chart ", CTRL + Key _ I , chartGroup , "pie chart " ); 
optionsPieChartAction -> setToggleAction ( TRUE ); 

그룹안의 매개 작용은 다른 작용들과 갈은 방법으로 창조된다. 그러나 작용의 부모 
는 폼이 아니라 그롭이다. 도표형의 작용들이 on/off 상태를 가지므로 그 매개에 대하여 
setToggleAction ( TRUE ) 를 호출한다. 작용들을 련결하지 않고 그대신에 후에 그룹을 
캔버스를 다시 그리는 처 리부에 련결한다. 


왜 그름을 직접 련결하지 않는가? 후에 구성자에서 사용자의 선택들을 
읽어들이는데 그 하나가 도표형이다. 그다음 그에 따라 도표형을 설정한다. 
그러나 그 시점에서 아직 캔버스를 창조하지 않거나 자료가 없으므로 우리가 할 
일은 캔버스형의 도구띠단추들을 절환하는것 이지만 그때 존재 하지 않는 캔버스를 
실제로 그리지 않고 캔버스형을 설정한 후에 그룹을 련결한다. _ 


사용자의 작용을 모두 창조한 다음 도구띠 와 차림 표선택들을 창조하여 사용자가 그것들 
을 호출할수 있게 한다. 

QToolBar* fileTools = new QToolBar( this, "file operations’’); 
fileTools->setLabel ( "File Operations " ) ； 
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fileNewAction -> addTo ( fileTools ) ； 
fileOpenAction -〉 addTo ( fileTools ) ； 
fileSaveAction -> addTo ( fileTools ) ； 


fileMenu = new QPopupMenu( this ) ； 
menuBar()->insertltem( " 技 File", fileMenu ) ； 
fileNewAction->addTo ( fileMenu ) ； 
fileOpenAction->addTo ( fileMenu ) ； 
fileSaveAction->addTo ( fileMenu ) ； 

도구띠의 작용과 차림표선택들은 QAction 들로부터 간단히 창조된다. 

사용자들이 편리하게 마지막 창문위치와 크기를 되살리고 최근에 사용한 파일들을 
렬거한다. 이것은 응용프로그람이 닫길 때 설정값들을 써 넣고 품을 구성할 때 그것들을 
읽어들임으로써 달성된다. 

QSettings settings ； 

settings.insertSearchPath( QSettings ： : Windows, WINDOWS_REGISTRY )； 
int windowWdth = settings.readNumEntry( APP_KEY + "WindowWidth", 460 )； 
int windowHeight = settings. readNumEntry ( APP_KEY + "WindowHeight", 530 ) ； 
int windowX = settings. readNumEntry( APP_KEY + "WindowX”, 一 1 ) ； 
int windowY = settings. readNumEntry ( APP_KEY + "WindowY", 一 1 ) ； 
setChartType (ChartType (settings. readNumEntry (APP_KEY + 

"ChartType", int (PIE ))))； 

m 一 font = QFont( ’’Helvetica", 18, QFont： : Bold ) ； 

m_font. fromString( settings. readEntry ( APP—KEY + "Font", 
m_font. toStringO ) ) ； 

for ( int i = 0; i < MAX_RECENTFILES ； ++i ) { 

QString filename = settings. readEntry ( APP_KEY + ’’File” + 
QString ： : number( i + 1 ) ); 

if ( !filename. isEmpty() ) 
m_recentFiles. push_back( filename ) ； 

} 

if ( m_recentFiles. count () ) 
updateRecentFilesMenu () ； 

QSettings 클라스는 가동환경에 의존하지 않는 방법으로 사용자의 설정을 처리한다. 
간단히 설정값들을 읽고쓰고 QSettings 이 가동환경의존관계를 조종한다. 
insertSearchPathO 호출은 아무 일도 하지 않는다. 

readNumEntryO 호출을 사용하여 도표픔의 마지 막 크기 와 위 치 를 얻 으며 이 함수가 처 음으 
로 실 행 되 면 기 정 값들을 제 공한다. 도표형 은 옹근수로 얻 어 지 고 ChartType 렬 거 형 으로 강제 변 
환된다. 기정표식서체를 창조하고 Font 설정 을 읽어들이며 필요하다면 기정값에 기초하여 창 
조한다. 

QSettings 가 문자렬목록을 취급할수 있더라도 최근에 사용한 매개 파일을 개별적 
인 항목에 보관하도록 선택하여 환경설정 을 간단히 손으로 편집하게 한다. 매 개의 가능 
한 파일항목 (’’ Filel ” 로부터 ” File 9 n 까지)을 읽어들이고 비지 않은 매개 항목을 최근에 
사용한 파일들의 목록에 추가한다. 최근에 사용한 파일들이 하나이상 있으면 
updateRecentFilesMenu 0를 호출하여 File 차림표를 갱신한다. 

connect ( chartGroup, SIGNAL ( selected (QAction*) ), 
this, SLOT( updateChartType(QAction*) ) ); 
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도표형 을 설정 하였 으므로 도표그롭을 updateChartTypeO 처 리 부에 련결 하는것 이 
안전 하다. 

resize ( windowWidth , windowHeight ) ； 
if ( windowX 卜 - 1 11 windowY != -1 ) 
move ( windowX , windowY ) ； 

그리고 창문의 크기와 위치를 알고있으므로 도표픔의 창문크기를 조절하고 이동할 
수 있다. 

m_canvas = new QCanvas ( this ); 
m _ canvas->resize ( width (), height () ) ； 

m_canvasView = new Can vas View ( m _ canvas , 技 m _ elements , this ) ； 
setCentral Widget ( m_can vas View ) ； 
m _ canvasView->show () ； 

새 로운 QCanvas 를 창조하고 그 크기를 도표폼창문의 의뢰령 역크기 로 설정한다. 또한 
CanvasView (QCanvasView 의 파생 클라스)를 창조하고 QCanvas 를 현시 한다. 캔버 스보기 를 도 
표폼의 기 본창문부품으로 만들고 그것 을 표시 한다. 
if ( ! filename . isEmpty () ) 
load ( filename ) ； 
else { 
initO ； 

m_elements [0]. set ( 20, red , 14, ’’ Red ” ) ； 
m _ elements [1]. set ( 70, cyan , 2, ’’ Cyan ”, darkGreen ) ； 
m 一 elements [2]. set ( 35, blue , 11, ” Blue ” ) ； 
m _ elements [3]. set ( 55, yellow , 1, " Yellow ", darkBlue ) ； 
m_elements [4]. set ( 80, magenta , 1, ’’ Magenta ” ) ； 
drawElementsO ； 

} 

적재할 파일이 있으면 적재하고 없으면 요소벡토르들을 초기화하고 견본도표를 그 
린다. 

statusBar () - > message ( " Ready ", 2000 ) ； 

구성자에서 statusBar 0를 호출하는것이 아주 중요하다. 이 호출은 상래띠를 기본 
창문용으로 창조한다. 

① initO 

void ChartForm： : initO 

{ 

setCaption ( ’’ Chart ” ) ； 
m_filename = QString ： : null ； 
m_changed = FALSE ； 

m_elements [0] = Element ( Element ： ： INVALID , red ) ； 

m _ elements [1] = Element ( Element ： ： INVALID , cyan ) ； 

m _ elements [2] = Element ( Element ： ： INVALID , blue ) ； 

품이 구성될 때 그리고 사용자가 현존자료모임을 적재하거 나 새로운 자료모임을 창조할 
때 마다 init () 를 사용하여 캔 버 스와 요소들 ( ElementVector 에 서 m _ elements ) 을 초기 화한다. 

제 목을 재 설정 하고 현재 파일 이 름을 QString :: null 로 설 정 iT 다. 또한 요소벡 토르를 무효요 
소들로 채운다. 이것은 필요하지 않지만 매개 요소에 다른 색을 주는것은 사용자가 값들을 입 
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력할때 매개가유일한색(변경가능)을 이미 가지고있으므로사용자에게 더 편리하다. 
(3) 파일조종작용 
① okToClearO 

bool ChartForm: : okToClearO 


if ( m_changed ) { 


QString msg ； 

if ( m _ filename . isEmpty () ) 
msg = "Unnamed chart "； 


else 


msg = QString ( ’’Chart ’% l ’\ n ” ). arg ( m_filename ) ； 
msg += "has been changed . ’， ； 


int x = QMessageBox ： : information ( this , ’’Chart -- Unsaved Changes ", 
msg , ’’ 技 Save ”, ’’ Cancel ”, M & Abandon ", 

0， 1 ); 
switch ( x ) { 
case 0： // Save 
fileSaveO ； 
break ； 

case 1： // Cancel 
default ： 


return FALSE ； 
case 2： // Abandon 
break ； 

} 

} 

return TRUE ； 

} 

okToClearO 함수는 보관하지 않은 자료가 있을 때 그것들을 보관하겠는가를 사용자에게 
묻는데 사용된다. 그것을 여러개의 다른 함수들이 사용한다. 

② fileNewO 

void ChartForm： : fileNewO 

{ 

if ( okToClearO ) { 
initO ； 

drawElementsO ； 


사용자가 fileNewO 작용을 호출할 때 okToClearO 를 호출하여 보관하지 않은 자료를 보관 
할 기회 를 준다. 보관히^거 나 무시 하거 나 보관할 자료가 없으면 요소벡 토르를 다시 초기화하고 
기정 도표를 그린다. 

또한 optionsSetDataO 를 호출하여 사용자가 값，색 등을 창조하고 
편집할수 있는 대화칸을 펼칠수 있어야 한다. 응용프로그람을 실행하고 
optionsSetDataO 에로의 호출을 추가하고 자기가 좋아하는것을 보려고 할수 
있 다. _ 
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③ fileOpenO 

void ChartForm： : fileOpenO 

{ 

if ( lokToClearO ) 
return ； 

QString filename = QFileDialog ： ： getOpenFileName ( QString ：： null , 
"Charts (*. cht )", this , "file open ", ’’Chart ~ File 
Open " ) ； 
if ( ! filename . isEmpty () ) 
load ( filename ) ； 
else 

statusBar ()-> message ( ’’File Open abandoned ", 2000 ) ； 

} 

그것 이 okToClear () 인 가 검 사하고 그러 면 정 적 함수 QFileDialog :: getOpenFileName () 에 의 
해 자용자가적 재하려 는 파일 의 이 름을 얻 고 load () 를 호출한다. 

④ fileSaveAsO 

void ChartForm： : fileSaveAsO 

{ 

QString filename = QFileDialog ： : getSaveFileName ( QString ：： null , 
"Charts (*. cht )", this , "file save as ", "Chart — File Save As " ) ； 
if ( ! filename . isEmpty () ) { 
int answer = 0； 
if ( QFile ： : exists ( filename ) ) 

answer = QMessageBox ： : warning ( this , ’’Chart — Overwrite File ", 
QString ( ’’ Overwrite \ n \’% l \’?’’ ). arg ( filename ), 

"& Yes M , ，，& No ”， QString ： mull , 1, 1 )； 
if ( answer == 0 ) { 
m_filename = filename ； 
updateRecentFiles ( filename ) ； 
fileSaveO ； 
return ； 

} 

} 

statusBar () - > message ( ’’Saving abandoned ", 2000 ) ； 

} 

이 함수는 정 적 함수 QFileDialog : : getSaveFileName 0를 호출하여 자료를 보관하 
려는 파일의 이름을 엄는다. 파일이 존재하면 QMessageBox::warning () 에 의하여 사 
용자에게 통지 하고 보관을 무시할수 있는 기회 를 준다. 파일 이 보관하려 고 한다면 최근 
에 연 파일목록을 갱신하고 fileSaveO (파일조종에서 취급)를 호출하여 보관한다. 

(4) 최근에 연 파일목록의 관리 
QStringList m _ recentFiles ； 

최근에 연 파일들^ 목록을 문자렬목록을 보관한다. 
void ChartForm ： : updateRecentFilesMenu () 

{ 
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for ( int i = 0； i < MAX _ RECENTFILES : ++i ) { 
if < fileMenu->findItem ( i ) ) 
fileMenu->removeltem ( i ); 
if ( i < int ( m _ recentFiles . count ()) ) 

fileMenu->insertItem ( QString ( "&%1 %2" ). arg ( i + 

1 ). arg ( m_recentFiles [ i ] )， 

this , SLOT ( fileOpenRecent ( int ) ), 0, i ); 


이 함수는 사용자가 현존파일을 열거나 새로운 파일을 보관할 때마다 보통 
updateRecentFiles 0를 통하여 호출된 다. 문자렬 목록안의 매개 파일에 대하여 새로운 
차림표항목을 삽입한다. 매개의 파일이름앞에 밑줄있는 번호 (1 〜 9) 를 배치하여 건반호 
출기능을 추가한다. (실례로 Alt + F , 2는 목록의 둘째 파일을 연다.) 차림표항목에 문자 
렬목록에 서 항목의 첨 수위치 와 같은 id 를 주고 매 개 차림 표항목을 fileOpenRecent 0 처 
리부에 련결한다. 낡은 파일차림표항목들은 매개의 가능한 최근파일차림표항목 id 를 통하 
여 동시에 람지된다. 이것은 다른 파일차림표항목들이 Qt 에 의해 창조된 id 를 가지고있 
으므로 제대로 동작한다. (그 모두는 0보다 작다.) 그런가 하면 우리가 창조한 차림표 
항목들은 모두 0이상의 id 를 가진다. 

void ChartForm ： : updateRecentFiles ( const QStringS filename ) 

{ 

if ( m _ recentFiles . find ( filename ) != m _ recentFiles . end () ) 
return ； 


m _ recentFiles . push _ back ( filename ); 
if ( m _ recentFiles . count 0 > MAX_RECENTFILES ) 
m _ recentFiles . pop _ front () : 


updateRecentFilesMenu () : 

} 

이것은 사용자가 현존파일들을 열거나 새로운 파일들을 보관할 때 호출된다. 파일 
이 이미 목록에 있으면 단순히 되돌아간다. 그렇지 않으면 파일이 목록의 끝에 추가되고 
목록이 너 무 크면(파일 이 10개 이 상이 면) 첫째 의 제 일 낡은 파일 이 삭제 된다. 
updateRecentFilesMenu 0이 그다음 호출되여 File 차림표에 최근에 사용한 파일들의 
목록을 다시 창조한다. 

void ChartForm ： : fileOpenRecent ( int index ) 

I 

if ( ! okToClear () ) 
return ； 

load ( m_recentFiles [ index ] ); 

} 

사용자가 최근에 연 파일을 선택할 때 선택한 파일의 차림표 id 에 의해 
fileOpenRecentO 처리 부가 호출된다. 파일 차림표 id 들을 m_recentFiles 목록에서 파일 
들의 첨 수위치 들과 같이 만들었 으므로 차림 표항목 id 에 의 해 색 인화된 파일 을 간단히 적 
재할수 있다. 

(5) 완료 
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void ChartForm： : fileQuitO 

{ 

if ( okToClearO ) { 
saveOptionsO ； 
qApp->exit( 0 ) ； 


사용자가 완료할 때 보관하지 않은 자료(실례로 창문의 크기와 위치，도표형 등)를 
보관할 기회를 완료하기전에 준다 (okToClearO). 
void ChartForm: : saveOptionsO 
{ 


QSettings settings ； 


settings.insertSearchPath( QSettings ： : Windows, WINDOWS_REGISTRY )； 
settings. writeEntry ( APP_KEY + ’’WindowWidth’’ ， width() ) ； 


settings. writeEntry ( 
settings. writeEntry ( 
settings. writeEntry ( 
settings. writeEntry ( 
settings. writeEntry ( 


APP_KEY + "WindowHeight", height() )； 
APP—KEY + "WindowX", x() )； 

APP_KEY + "WindowY", y() )； 

APP_KEY + "ChartType", int(m_chartType) ) ； 
APP_KEY + ， ’ AddValues", int(m_addValues) )； 


settings. writeEntry ( APP_KEY + ” Decimals’’ ， m_decimalPlaces ) ； 
settings. writeEntry( APP_KEY + ’’Font”, m_font. toStringO ) ； 
for ( int i = 0 ； i < int(m_recentFiles.count()) ； ++i ) 


settings. writeEntry( APP_KEY + ’’File” + QString ： ： number( i + 1 ), 
m_recentFiles [i] ) ； 


QSettings 를 리용하여 사용자의 선택값들을 보관하는것은 간단하다. 

(6) 사용자정의대화칸 

사용자가 일부 선택을 수동적으로 설정하고 값들과 값들의 색 등을 창조하고 편집 
할수 있게 하려고 한다. 

void ChartForm ： : optionsSetOptions() 

{ 


OptionsForm *optionsForm = new OptionsForm( this ) ； 
optionsForm->chartTypeComboBox->setCurrentItem( m_chartType ) ； 
optionsForm->setFont ( m_font ) ； 
if ( optionsForm->exec () ) { 
setChartType( ChartType ( 

optionsForm - 〉 chartTypeComboBox- 〉 currentItem()) ) ； 
m_font = optionsForm->font() ； 
drawElementsO ； 


} 

delete optionsForm ； 

} 

선택값들을 설정하기 위한 폼은 사용자정의 OptionsForm 에 의해 제공된다. 선택픔 
은 실례를 창조하고 그의 모든 GUI 요소들을 관련한 설정값들로 설정하고 사용자가 OK 
를 찰칵하면 (execO 가 true 값을 돌려준다.) GUI 요소들로부터 설정값들을 다시 읽어들 
인다. 
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void ChartForm ： ： optionsSetData () 

{ 

SetDataForm *setDataForm = new SetDataForm ( 技 m _ elements , 

m _ decimalPlaces , this ) ； 

if ( setDataForm -〉 exec 0 ) { 
m_changed = TRUE ； 
drawElementsO ； 

} 

delete setDataForm ； 

} 

도표자료를 창조하고 편집하기 위한 픔은 사용자정의 SetDataForm 에 의해 제공된다. 
작업하려고 하는 자료구조를 넘기고 대화칸은 자료구조자체의 제시를 조종한다. 사용자 
가 OK 를 찰칵하면 대화칸이 자료구조를 갱신하고 execO 는 true 값을 돌려준다. 사용자 
가 자료를 변경하였을 때 optionsSe 付 DataO 에서 해야 할 일은 도표를 변경된것으로 표 
식하고 drawElementsO 를 호출하여 새로운 갱신값으로 도표를 다시 그리는것이다. 

5. 캔버스조종 

원도표의 부채형토막 (혹은 막대도표의 막대들)，그리고 표식자들을 캔버스우에 그 
린다. 캔버스는 캔버스보기를 통하여 사용자에게 표시된다. drawElementsO 함수는 필 
요할 때 캔버스를 다시 그리기 위하여 호출된다. 다음의 코드는 
chartform _ canvas . cpp 에 서 발취 한것 이 다. 

(1) drawElementsO 
void ChartForm： : drawElementsO 
{ 

QCanvasItemList list = m _ canvas->allItems () ； 

for ( QCanvasItemList： : iterator it = list . begin () ； it != list . end () ； ++it ) 
delete * it ; 

그리 려 는 도표형 에 의 존하는 비 례 결 수를 계 산한다. 
double biggest = 0.0； 
int count = 0； 
double total = 0.0; 

static double scales [ MAX . ELEMENTS ] ； 


for ( int i = 0； i < MAX_ELEMENTS ； ++i ) { 
if ( m_elements [1]. isValid () ) { 
double value = m_elements [ i ]. value () ； 
count ++； 
total += value ； 
if ( value > biggest ) 
biggest = value ； 

scales [ i ] = m_elements [ i ]. value () * scaleFactor ； 

} 


if ( count ) { 

// 2 nd loop because of total and biggest 
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for ( int i = 0 ； i < MAX_ELEMENTS ； ++i ) 
if ( m_elements [i]. isValidO ) 
if ( m_chartType == PIE ) 

scales [i] = (m_elements [i]. value () * scaleFactor) / total ； 
else 

scales[i] = (m_elements[i].value() * scaleFactor) / biggest ； 

값의 개 수，최 대 값과 총 ^! 를 알아야 정 확히 비 례 되 는 부채 형 이 나 막대 들을 창조할수 있 다 . 
scales 배 렬 에 비 례 값들을 보관한다 . 

switch ( m_chartType ) { 
case PIE ： 

drawPieChart( scales, total, count ) ； 
break ； 

case VERTICAL_BAR ： 

drawVerticalBarChart( scales, total, count ) ； 
break ； 

case HORIZONTAL-BAR: 

drawHorizontalBarChart( scales, total, count ) ； 
break ； 

} 

} 

캔버스를 update0 하여 변경이 나타나게 한다 . 

① drawHorizontalBarChart () 

비례값들의 배렬，총계값(필요할 때 퍼센트를 계산하고 그리기 위하여)，값들의 개수가 필 
요하다 . 

double width = m_canvas -〉 width () ; 
double height = m_canvas->height() ； 
int proheight = int (height / count) ； 
int y = 0 ； 

캔버스의 폭과 높이를 얻고 비례높이 (proheight) 를 계산하고 초기의 y 위 치를 0 으 
로 설정한다 . 

QPen pen ； 

pen.setStyle( NoPen ) ； 

매 개 막대 (직 4 각형 )를 그리 는데 사용할 펜 을 창조하고 그것 을 NoPen 으로 설정 하여 테 두 
리선이 그려지지 않게 한다 . 

for ( int i = 0 ； i < MAX_ELEMENTS ； ++i ) { 
if ( m_elements [ i ] .isValidO ) { 
int extent = int (scales [i]) ； 

요소벡토르에서 무효요소들을 뛰여념으면서 매개 요소를 순환한다 . 매개 막대의 범위(그 
길 이 ) 는 단순히 그 비 례 값 (scaled value) 이 다 . 

QCanvasRectangle *rect = new QCanvasRectangle(0, y, extent, 
proheight, m_canvas ); 

rect->setBrush( QBrush( m_elements [i]. valueColor(), 

BrushStyle (m_elements [i]. valuePattern ())))； 
rect->setPen( pen ) ； 
rect->setZ( 0 ); 
rect - 〉 showO; 
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매개 막대에 대하여 x 위치가 0( 이것은 매개 막대가 왼쪽에서 시작하는 수평막대도 
표이므로ᄂ y 값이 0 으로 시작하고 매개 막대를 그릴 때 그 높이만큼 커지는 새로운 
QCanvasRectangle 을 창조한다 . 그려지는 높이는 막대의 높이와 막대를 그리는 캔버 
스의 높이에 의해 결정된다 . 그다음 사용자가 요소에 대하여 지정한 색과 패턴으로 막대 
의 솔을 설정 하고 펜을 처 음에 창조한 펜(즉 NoPen) 으로 설정 한다 . 그리 고 고차원에 서 
위치 0 에 막대를 배치한다 . 끝으로 showO 를 호출하여 캔버스우에 막대를 그린다 . 
QString label = m_elements [i]. label 0 : 
if ( !label.isEmptyO || m_addValues != NO ) { 
double proX = m_elements [i]. proX( HORIZONTAL_BAR ); 
double proY = m_elements[i] .proY( HORIZONTAL_BAR ); 
if ( proX < 0 | | proY < 0 ) { 
proX = 0 ； 
proY = y / height; 

} 

사용자가 그 요소에 대 한 표식 을 지 정 하거 나 값(혹은 퍼 센트)들을 표시 하도록 요구하면 
캔버 스본문항목도 그린 다 . 매 개 캔버 스본문항목안의 대 응하는 요소첨 수를 보관하여 야 하므로 
자체 의 CanvasText 콜라스를 창조한다 . 요소로부터 표와 모의 비 례 값들을 꺼 낸 다 . 0 보다 작으면 
사용자가 위 치 를 지 정 하지 않았으므로 그 위 치 를 계 산한다 . 표식 자의 x 값을 0( 왼쪽 ) ， y 값을 막 
대 의 웃끝으로 설정한다 . (그리하여 표식 자의 왼쪽웃구석 이 바로 x,y 위 치 로 된다 .) 

label = valueLabel ( label, m_elements[i]. value(), total ); 

그다음 표식 자본문을 포함하는 문자렬 을 돌려 주는 valueLabel () 을 호출한다 . (valueLabel() 
함수는 사용자가 적 당한 선택 들을 설정 하였 다면 본문표식 자에 값이 나 퍼 센트를 추가한다 .) 

CanvasText *text = new CanvasText( i, label, m_font, m_canvas ); 

text->setColor( m_elements ； [i]. labelColorO ); 

text->setX( proX * width ); 

text->setY ( proY * height ) : 

text->setZ( 1 ); 

text->show() : 

m_elements [i]. setProX( HORIZONTAL_BAR, proX ); 
m_elements[i].setProY( HORIZONTAL_BAR, proY )； 

그다음 요소벡토르에서 이 요소의 첨수，표식자，사용하려는 서체와 캔버스를 넘기 
여 항목을 창조한다 . 본문항목의 본문색을 사용자가 지정한 색으로 설정하고 항목의 x 
와 y 위치들을 캔버스의 폭과 높이에 비례되게 설정한다 . 고차원을 1 로 설정하여 본문항 
목이 늘 막대 (그 고차원은 0 ) 우에 ( 정면에 ) 있게 한다 . showO 를 호출하여 캔버스에 본 
문항목을 그리 고 요소의 상대적 인 표와 y 위 치들을 설정 한다 . 

} 

y += proheight ； 

막대와 그 표식자를 그린 후에 모를 비례높이만큼 증가하고 다음 요소를 그릴 준비 
를 한다 . 

} 

} 

} 

(2) QCanvasText 의 파생클라스 만들기 
// canvastext.h. 로부터 발취 
class CanvasText : public QCanvasText 
{ 
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public： 

enum { CANVAS.TEXT = 1100 }； 


CanvasText( int index, QCanvas *canvas ) 

: QCanvasText( canvas ), m_index( index ) {} 

CanvasText( int index, const QString 技 text, QCanvas *canvas ) 

: QCanvasText( text, canvas ), m_index( index ) {} 

CanvasText( int index, const QStringS text, QFont font, QCanvas 
*canvas ) 

: QCanvasText( text, font, canvas ), m_index( index ) {} 

int index() const { return m_index ； } 

void setlndex( int index ) { m 一 index = index ； } 

int rttiO const { return CANVAS 一 TEXT; } 

private ： 
int m_index ； 

}； 

CanvasText 과생 들라스는 QCanvasText 의 아주 단순한 특수화이다 . 우리 가 할 
일은 이 본문항목과 련관된 요소벡토르첨수를 보관하는 하나의 비공개성원 mjndex 를 
추가하고 이 값을 위한 얻기함수와 설정 함수들을 제공하는것 이 다 . 

(3) QCanvas View 의 파생클라스화 
// canvasview.h 로부터 발취 
class CanvasView : public QCanvasView 
{ 

Q—OBJECT 

public ： 

CanvasView( QCanvas *canvas, ElementVector ^elements, 

QWidget* parent = 0, const char* name = ’’canvas view", WFlags f = 0 ) 

: QCanvasView( canvas, parent, name, f ), m_movingltem(0), 
m_elements( elements ) {} 


protected： 

void viewportResizeEvent ( QResizeEvent *e ) ； 

void contentsMousePressEvent ( QMouseEvent *e ) ； 

void contentsMouseMoveEvent ( QMouseEvent *e ) ； 

void contentsContextMenuEvent ( QContextMenuEvent *e ); 


private： 

QCanvasItem *m_movingItem ； 

QPoint m_pos ； 

ElementVector *m_elements; 

}； 

다음과 같은 기 능을 처 리 할수 있 도륵의 파생 클라스를 만들 필 요가 있 다 . 
① 상황차림표요구 
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② 폼크기조절 

③ 임의의 위치로 표식자를 끌고가기 

이것들을 유지 하기 위 하여 이동하고있는 지시 자와 그 마지막위 치를 보관하며 요소백토 
르의 지적 자도 보관한다 . 

- 상황차림표의 유지 

// canvas view, cpp 로부터 발취 

void CanvasView :: contentsContextMenuEvent ( QContextMenuEvent * ) 

{ 

((ChartForm*)parent()) - >optionsMenu->exec( QCursor: :pos() ) ； 

} 

사용자가 상황차림표를 호출할 때(실례로 대부분의 가동환경에서 오른단추를 찰칵 
하여 ) 캔버스보기의 부모 ( 도표품)를 정확한 형으로 강제변환하고 유표의 위치에서 선택 
차림표를 실행한다 . 

- 크기 조종 

void CanvasView :: viewportResizeEvent ( QResizeEvent *e ) 

{ 

canvas()->resize( e->size(). width(), e->size().height() ) ； 

((ChartForm*) parent 0)->drawElements 0 ; 

} 

크기를 조절하기 위하여 단순히 캔버스보기가 픔의 의뢰령역의 폭과 높이를 표시하 
는 캔버스의 크기를 조절하고 drawElementsO 를 호출하여 도표를 다시 그린다 . 
drawElementsO 가 캔버스의 폭과 높이 에 상응하게 그리므로 도표는 정확히 그려전다 . 

- 주어진 위치로 끌기 

사용자가 표식자를 일정한 위치로 끌고가려고 할 때 그것을 찰칵하고 새 위치에로 
끌고가서 놓는다 . 

void Can vas Vie w :: contentsMouseP ressE vent ( QMouseEvent *e ) 

{ 

QCanvasItemList list = canvas () - >collisions ( e->pos() ) ； 
for ( QCanvasItemList： : iterator it = list.begin() ； it != list.end() ； ++it ) 
if ( (*it)->rtti() == CanvasText ： : CANVAS_TEXT ) { 
m_movingItem = *it; 
m_pos = e- 〉 pos(); 
return ； 

} 

m_movingItem = 0 ； 

} 

사용자가 마우스를 찰칵할 때 유표위치에 캔버스항목 ( 있다면)들의 목록을 창조한다 . 
그다음 목록을 순환하여 CanvasText 항목을 찾으면 그것을 이동할 항목으로 설정하고 
그 위치를 기록한다 . 그렇지 않으면 이동할 항목이 없는것으로 설정한다 . 

void CanvasView :: contentsMouseMoveEvent ( QMouseEvent *e ) 

{ 

if ( m_movingItem ) { 

QPoint offset = e->pos () - m_pos ； 
m_movingItem->moveBy( offset. x(), offset. y() ); 
m_pos = e->pos() ； 

ChartForm *form = (ChartForm*) parent () ； 
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form->setChanged ( TRUE ) ； 

int chartType = form->chartType() ； 

CanvasText *item = (CanvasText*) m_movingItem ； 
int i = item->index() ； 

(*m_elements) [i]. setProX( chartType, item->x() / canvas 0 -〉 width 0 ); 
(*m_elements) [i]. setProY( chartType, item->y() / canvas ()->height () ) ； 

canvas () ->update () ； 


사용자가 마우스를 끌기할 때 이동사건이 발생된다 . 이동할 항목이 있으면 마지막 
마우스위치로부터의 편차를 계산하고 항목을 그 편차량만큼 이동한다 . 새 위치를 마지막 
위치로서 기록한다 . 도표가 현재 변경되였으므로 setChangedO 를 호출하여 사용자가 
완료하거나 현존도표를 적재하거나 새 도표를 창조하려고 하는 경우에 보관하겠는가 하 
는 재촉문이 표시되게 한다 . 또한 현재 도표형에 대하여 요소의 표와 모의 비례위치들을 
폭과 높이에 각각 비례하는 현재의 표와 y 위치들로 갱신한다 . 매개 캔버스항목을 창조 
할 때 거기에 대응하는 요소의 첨수위치를 넘겨 야 하므로 갱신하여 야 할 요소를 알고있 
다 . QCanvasText 의 파생클라스를 만들어서 이 첨수값을 설정하고 얻을수 있다 . 끝으 
로 update 0 를 호출하여 캔버스를 다시 그린다 . 


QCanvas 는 시각적 인 표시 가 없다 . 캔버 스의 내 용을 알려 면 
QCanvasView 를 창조하여 캔버스를 표시하여야 한다 . 매개 항목에 대하여 
show 0 를 호출하고 QCanvas: : update 0 를 호출하여 야만 그것 들이 캔버 스보기 
에 나타난다 . 기정으로 QCanvas 의 배경색은 백색이고 기정으로 캔버스우에 그 
려진 도형들 실례로 QCanvasRectangle, QCanvasEllipse 등은 백색으로 색 
칠되므로 백색이 아닌 솔을 설정하는것이 좋다 . _ 


6. 과일조종 

다음의 코드는 chartfomi_files.cpp 에 서 발취 한것 이 다 . 

① 도표자료의 읽어들이구 1 

void ChartForm ： ： load( const QString 技 filename ) 

{ 

QFile file( filename ) ； 

if ( !file, open ( IO_ReadOnly ) ) { 

statusBar()->message( QString( "Failed to load ).ar 答 ( filename ), 2000 )； 

return ； 


initO ； // 색들을 가지고있는가 확인 
m_filename = filename ； 
QTextStream ts( Sfile ) ； 

Element element ； 
int errors = 0 ； 
int i = 0 ； 

while ( Its.eof() ) { 
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ts » element ； 
if ( element. isValidO ) 
m_elements [i++] = element ； 
file.closeO ； 

setCaption( QStringC "Chart — %1” ).arg( filename ) ); 
updateRecentFiles ( filename ) ； 

drawElementsO; 
m_changed = FALSE ； 

} 

자료모임의 적재는 아주 간단하다 . 파일을 열고 본문스트림을 창조한다 . 읽어들일 
자료가 있으면 요소를 element 에 흘러 보내 고 그것 이 유효이 면 m_elements 벡 토르에 삽입 한 
다 . 모든 세 부는 Element 클라스에 의해 조종된 다 . 그다음 파일 을 닫고 제 목과 최 근파일 
목록을 갱 신한다 . 끝으로 도표를 그리 고 그것 을 변경하지 않은것 으로 표식한다 . 

② 도표자료의 써넣기 
void ChartForm： : fileSaveO 
{ 

QFile file( m_filename ) ； 

if ( !file, open ( IO_WriteOnly ) ) { 

statusBar()->message( QString( "Failed to save \’%1 入 ’’’ ).ai 答 ( m_fllename )，2000 )； 
return ； 

} 

QTextStream ts( &file ) ； 
for ( int i = 0 ； i < MAX_ELEMENTS ； ++i ) 
if ( m_elements[i].isValidO ) 
ts « m_elements [i] ； 

file.closeO; 

setCaption( QString( "Chart — %V ).arg( m_filename ) ) ； 
statusBarO — 〉 message( QStringC ’’Saved ).arg( m_filename )，2000 )； 

m_changed = FALSE ； 

} 

자료보관도 간단하다 . 파일을 열고 본문스트림을 창조한 다음 매개 유효요소들을 
본문스트림에 보낸다 . 모든 세부는 Element 클라스에 의해 조종된다 . 
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7. 자료취급 



그림 2-1 8. 자료의 취급 

자료설정대화칸은 사용자가 값들을 추가 및 편집하게 하며 값들을 현시하는데 사용 
할 색과 패런을 선택하게 한다. 또한 사용자들은 표식자본문을 입력하고 매개 표식자의 
색을 선택할수 있다. 

// setdataform.h 로부터 발취 
class SetDataForm： public QDialog 
{ 

Q—OBJECT 

public： 

SetDataForm ( ElementVector ^elements, int decimalPlaces, QWidget *parent = 
0,const char *name = ’’set data form", bool modal = TRUE, WFlags f = 0 )； 
~SetDataForm() {} 
public slots： 
void setColorO ； 

void setColor( int row, int col ) ； 
void currentChanged ( int row, int col ) ； 
void valueChanged( int row, int col ) ； 
protected slots： 
void accept () ； 
private : 

QTable *table; 

QPushButton *colorPushButton ； 

QPushButton *okPushButton; 

QPushButton *cancelPushButton; 
protected： 

QVBoxLayout *tableButtonBox ； 

QHBoxLayout *buttonBox; 
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private ： 

ElementVector *m_elements; 
int m_decimalPlaces ； 

}； 

머 리부파일은 간단하다 . 구성 자는 요소벡 토르의 지적 자를 가지 고있으므로 이것을 
사용하여 대화칸을 현시하고 자료를 직접 편집할수 있다 . 

// setdataform.cpp 로부터 발취 
#include ’’images/patternOl. xpm” 

#include "images/pattern02.xpm” 

자그마한 .XPM 화상을 창조하여 Qt 가 제공하는 매개 솔패턴을 보여준다 . 패런복합 
칸에서 이것들을 사용한다 . 

(1) 구성자 

SetDataForm :: SetDataForm ( ElementVector ^elements, int decimal Places, 
QWidget* parent, const char* name, bool modal, WFlags f ) 

: QDialog( parent, name, modal, f ) 

{ 

m_elements = elements ； 
m_decimal Places = decimal Places ； 

QDialog 기초클라스에 대부분의 인수를 넘긴다 . 요소벡토르지적자와 현시하려는 10 
진자리수들을 성원변수들에 할당하여 그것들을 SetDataForm 의 모든 성원함수들에서 호 
출할수 있도륵 한다 . 

setCaption ( ’’Chart、-— Set Data” ) ； 
resize( 540, 440 ) ； 

대화칸의 제목을 설정하고 크기를 조절한다 . 
tableButtonBox = new QVBoxLayout( this, 11, 6, "table button box 
layout” ) ； 

폼의 배치는 아주 간단하다 . 단추들은 수평배치관리자에 모두 그룹화되고 표와 단 
추의 배치는 tableButtonBox 배치관리자에 의하여 수직으로 그롭화된다 . 
table = new QTable( this, "data table” ) ； 
table->setNumCols ( 5 ) ； 

table->setNumRows ( ChartForm： : MAX_ELEMENTS ) ； 
table->setColumnReadOnly ( 1, TRUE ) ； 
table->setColumnReadOnly( 2, TRUE ); 
table->setColumnReadOnly ( 4, TRUE ) ； 
table->setColumnWidth( 0, 80 ) ； 

table->setColumnWidth( 1, 60 ); // 1 렬과 4 렬은 같아야 한다 
table->setColumnWidth( 2, 60 ) ； 
table->setColumnWidth( 3, 200 ) ； 
table->setColumnWidth( 4, 60 ) ； 

QHeader *th = table->horizontalHeader() ； 
th->setLabel( 0, "Value" )； 
th->setLabel ( 1, ’’Color” ) ； 
th->setLabel ( 2, "Pattern" ) ； 
th->setLabel( 3, "Label" ) ； 
th->setLabel( 4, ， ’ Color” ); 
tableButtonBox - 〉 addWidget( table ) ； 
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5 개의 렬과 요소벡토르안의 요소수와 같은 행수를 가지는 QTable 을 새로 창조한 
다 . 색과 패런렬들을 읽기전용으로 만든다 . 이것은 사용자의 입력을 막기 위해서이다 . 
사용자가 색을 찰칵하거나 Color 단추를 찰칵하여 색을 변경할수 있게 만든다 . 패런은 
복합칸안에 있으며 사용자가 다른 패 런을 선택 하여 간단히 변경할수 있다 . 다음으로 초 
기폭을 적당히 설정하고 매개 렬의 표식자를 삽입하고 끝으로 표식자를 
tableButtonBox 배치관리자에 추가한다 . 

buttonBox = new QHBoxLayout( 0 ， 0, 6, "button box layout f, ) ； 
단추들을 보관하기 위 한 수평칸배 치 관리 자를 창조한다 . 
colorPushButton = new QPushButton( this, "color button’’ ) ； 
colorPushButton - 〉 setText( ”&Color... n ) ； 
colorPushButton->setEnabled ( FALSE ); 
buttonBox - 〉 addWidget( colorPushButton ) ； 

색단추를 창조하고 거기에 buttonBox 배 치관리자를 추가한다 . 단추를 금지하고 색 
세포우에 실제로 초점이 있을 때만 그것을 허용한다 . 

QSpacerltem *spacer = new QSpacerItem( 0, 0, 

QSizePolicy ： : Expanding, QSizePolicy ： : Minimum ) ； 
buttonBox - 〉 addltem( spacer ) ； 

색단추를 OK 와 Cancel 단추로부터 분리 하기 위 하여 다음에 수축자를 창조하고 그 
것을 buttonBox 배 치관리자에 추가한다 . 

okPushButton = new QPushButton( this, "ok button" ) ； 
okPushButton->setText ( "OK” ) ； 
okPushButton->setDefault ( TRUE ) ； 
buttonBox->addWidget ( okPushButton ) ； 

cancelPushButton = new QPushButton( this, ’’cancel button" ) ； 
cancelPushButton->setText( ’’Cancel” ) ； 
cancelPushButton->setAccel ( Key_Escape ) ； 
buttonBox - 〉 addWidget( cancelPushButton ) ； 

◦災와 Cancel 단추를 창조하여 buttonBox 에 추가하였다 . OK 단추를 대화칸의 기 
정단추로 만들고 Esc 건을 Cancel 단추의 지름건으로 만든다 . 
tableButtonBox->addLayout ( buttonBox ) ； 
buttonBox 배치관리자를 tableButtonBox 에 추가하고 배치를 완성한다 . 
connect ( table, SIGNAL ( clicked (int, int, int, const QPoint&) ), 
this, SLOT( setColor(int,int) ) ) ； 
connect ( table, SIGNAL ( currentChanged(int, int) ), 
this, SLOT( currentChanged(int, int) ) ) ； 
connect ( table, SIGNAL ( valueChanged(int, int) ), 
this, SLOT( valueChanged(int, int) ) ) ； 
connect( colorPushButton, SIGNAL( clicked0 ), this, SLOT( setColorO ) )； 
connect( okPushButton, SIGNAL( clicked0 ), this, SLOT( accept() ) )； 
connect( cancelPushButton, SIGNAL( clicked() ), this, SLOT( reject() ) )； 
이제는 폼을《련결 (wire up) 》 한다 . 

•사용자가 세포를 하나 찰칵하면 setColorO 처리부를 호출한다 . 이것은 세포가 색 
을 보유하고 있으면 색대화칸을 펼친다 . 

• QTable 의 currentChangedO 신호를 자체의 currentChangedO 처리부에 련결 
한다 . 이것은 색단추를 (실례 로 사용자가 어 느 란안에 있는가에 따라서 ) 허용/금지 하는 
데 쓰인다 . 
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• 표의 valueChangedO 신호를 자체의 valueChangedO 처리부에 련결한다 . 이것 
을 사용하여 값을 정확한 개수의 10 진자리로 현시한다 . 

• 사용자가 Color 단추를 찰칵하면 setColorO 처 리부를 호출한다 . 

• OK 단추는 accept 0 처리부에 련결된다 . 이 처리부에서 요소백토르를 갱신한다 . 

• Cancel 단추는 QDialog 의 rejectO 처리부에 련결되고 코드와 작용을 더는 요구 
하지 않는다 . 

QPixmap patterns [MAX_PATTERNS] ； 
patterns [0] = QPixmap ( patternOl ) ； 

patterns [1] = QPixmap ( pattern02 ) ； 

매개 솔패런의 픽스매프를 창조하여 patterns 배렬에 보관한다 . 

QRect rect = table - 〉 cellRect( 0， 1 ); 

QPixmap pix( rect. width (), rect. height() ) ； 

매개 색세포가 차지하는 직 4 각형을 얻고 그 크기의 빈 픽스매프를 창조한다 . 
for ( int i = 0 ； i < ChartForm ： : MAX_ELEMENTS ； ++i ) { 

Element element = (*m_elements) [i] ； 


if ( element. isValidO ) 

table - 〉 setText( i, 0, QString( ”%1” ).arg( element.value(), 0, ’f’, 
m_decimalPlaces ) ) ； 

QColor color = element. valueColorO ； 

pix.fill( color ) ； 

table - 〉 setPixmap( i, 1, pix ) ； 

table - 〉 setText( i, 1, color, name () ) ； 

QComboBox *combobox = new QComboBox ； 
for ( int j = 0 ； j < MAX_PATTERNS ； ++j ) 
combobox->insertItem ( patterns [j] ) ； 

combobox->setCurrentItem( element. valuePatternO - 1 ) ； 

table->setCellWidget( i, 2, combobox ); 

table - 〉 setText( i, 3, element, label () ) ； 

color = element. labelColorO ； 

pix. fill ( color ) ； 

table - 〉 setPixmap( i, 4, pix ) ； 

table - 〉 setText( i, 4, color. nameO ) ； 

요소벡토르의 매개 요소들로 표를 채워넣어야 한다 . 

요소가 유효이면 특정한 개수의 10 진자리수로 형식화하여 첫 란에 그 값을 써넣는다 . 

요소값의 색 을 읽어 들이 고 빈 픽 스매 프를 그 색 으로 채 운다 . 그다음 현시 하려 는 색 
세포를 이 픽스매프로 설정한다 . 후에 반대로 색을 읽어들일수 있어야 한다(실례로 사용 
자가 그것을 변경한다면 ). 이것을 수행하는 한가지 방법은 픽스매프안의 화소를 시험하 
는것이고 다른 방법은 (CanvasText 파생클라스에서와 같은 방법으로 ) QTableltem 의 
파생클라스를 만들고 거기에 색을 보관하는것이다 . 그러나 더 간단한 로정을 선택하고 
세 포의 본문을 색이 름으로 설정 한다 . 

다음에 패런복합칸을 패턴들로 채운다 . 복합칸에서 선택한 패런의 위치를 리용하여 
사용자가 선택한 패런을 결정한다 . QTable 은 QComboTableltem 항목들을 사용할수 
있으나 이것들은 본문만 보유하므로 setCellWidget 0 을 사용하여 표에 QComboBox 의 
항목들을 삽입한다 . 

다음에 요소의 표식 자를 삽입 한다 . 끝으로 값의 색 을 설정할 때 와 같은 방법 으로 
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표식자색을 설정한다 . 

(2) 처리부 

void SetDataForm： : currentChanged( int, int col ) 

{ 

colorPushButton->setEnabled( col == 1 11 col == 4 ) ； 

} 

사용자가 표를 항행할 때 currentChangedO 신호가 발생된다 . 사용자가 1 렬 이 나 
4 렬(값의 색 혹은 표식자색)에 입력할 때 colorPushButton 을 허용하고 그렇지 않으면 
그것을 금지한다 . 

void SetDataForm： : valueChanged( int row, int col ) 

{ 

if ( col == 0 ) { 
bool ok ； 

double d = table->text( row, col ).toDouble( 技 ok ) ； 
if ( ok && d > EPSILON ) 

table->setText( row, col, QString( ).arg( d, 0, ’f ’， 

m_decimalPlaces ) ) ； 

else if ( !table - 〉 text( row, col ).isEmpty() ) 
table->setText( row, col, table - 〉 text( row, col ) + ) ； 

} 

} 

사용자가 값을 변경하면 정확한 개수의 10 진자리들로 그것을 형식화하거나 그것이 
무효라는것을 지적해야 한다 . 

void SetDataForm :: setColorO 

{ 

setColor( table - 〉 currentRowO, table -〉 currentColumnO ) ； 
table->setFocus () ； 

} 

사용자가 Color 단추를 찰칵하면 다른 setColorO 함수를 호출하고 표에로 초점을 
돌려야 한다 . 

void SetDataForm ： : setColor( int row, int col ) 

{ 

if ( ! ( col == 1 | | col == 4 ) ) 
return ； 

QColor color = QColorDialog ： : getColor( QColor( table->text( row, 
col ) ) ， this, ’’color dialog" ) ； 
if ( color. isValidO ) { 

QPixmap pix = table->pixmap( row, col ) ； 
pix.fill( color ) ； 

table - 〉 setPixmap( row, col, pix ) ； 
table - 〉 setText( row, col, color, name() ) ； 

} 

} 

이 함수가 색세 포에 초점 이 놓이 여 호출되 면 정 적 QColorDialog: :getColor() 대 
화칸을 호출하여 사용자의 색선택을 엄는다 . 색을 선택하면 색세포의 픽스매프를 그 색 
으로 채우고 세포의 본문을 새로운 색의 이름으로 설정한다 . 
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void SetDataForm： : accept () 

{ 

bool ok ； 

for ( int i = 0 ； i < ChartForm ： : MAX_ELEMENTS ； ++i ) { 

Element &element = (*m_elements) [i] ; 
double d = table->text( i, 0 ).toDouble( 技 ok ) ； 
if ( ok ) 

element. setValue( d ) ； 
else 

element. setValue( Element ： ：INVALID ) ； 
element. setValueColor( QColor( table->text( i, 1 ) ) ) ； 
element. setValuePattern (((QComboBox*) table->cell Widget ( i, 2 ))- 

>currentltem ()+1) ； 

element.setLabel( table->text( i, 3 ) )； 

element. setLabelColor( QColor( table->text( i, 4 ) ) ) ； 


QDialog： : accept 0 ； 

} 

사용자가 OK 를 찰칵하면 요소백토르를 갱신한다 . 백토르를 순환하면서 매개 요소 
의 값을 사용자가 입력한 값으로 설정하고 값이 무효이면 INVALID 로 설정한다 . 인수 
와 갈은 색이 름을 가지 는 QColor 를 일 시 구성 함으로써 값의 색 과 표식 자색 을 설정 한다 . 
패런은 번호 1 을 가지는 패런복합칸의 현재항목으로 설정된다 . (패런번호는 1 로 시작하 
지만 복합칸의 항목들은 첨수 0 으로 시 작한다 . ) 

끝으로 QDialog: : accept 0 를 호출한다 . 

8. 환경의 설정 



그림 2-1 9. 환경의 설정 
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선택대화칸을 제공하여 사용자가 한곳에서 모든 자료모임들에 적용하는 환경선택값 
들을 설정하도록 한다 . 

// optionsform.h 로부터 발취 
class OptionsForm : public QDialog 
{ 

Q_OBJECT 

public ： 

OptionsForm( QWiget* parent = 0， const char* name = "options form", 
bool modal = FALSE, WFlags f = 0 )； 

^OptionsForm() {} 

QFont fontO const { return m_font ； } 
void setFont( QFont font ) ； 

QLabel *chartTypeTextLabel ； 

QComboBox *chartTypeComboBox ； 

QPushButton *fontPushButton; 

QLabel *fontTextLabel; 

QFrame *addValuesFrame ； 

QButtonGroup *addValuesButtonGroup ； 

QRadioButton *noRadioButton ； 

QRadioButton *yesRadioButton ； 

QRadioButton *asPercentageRadioButton ； 

QLabel *decimalPlacesTextLabel; 

QSpinBox *decimalPlacesSpinBox; 

QPushButton *okPushButton ； 

QPushButton *cancelPushButton; 


protected slots ： 
void chooseFontO ； 

protected ： 

QVBoxLayout *optionsFormLayout; 
QHBoxLayout *chartTypeLayout ； 
QHBoxLayout *fontLayout; 

QVBoxLayout *addValuesFrameLayout ； 
QVBoxLayout *addValuesButtonGroupLayout ； 
QHBoxLayout *decimal P lacesLayout ； 
QHBoxLayout *buttonsLayout ； 


private ： 

QFont m_font ； 

}； 

이 대화칸의 배치는 자료설정폼보다 훨씬 더 복잡하지만 하나의 처리부만 요구한다 . 
자료설정품과 달리 이것은 호출자가 설정 하고 읽어들이는 창문부품들을 단순히 제 공하는 
대화칸이 다 . 호출자는 사용자가 만드는 변경에 기초한 갱신에 대응할수 있다 . 
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// optionsform.cpp 로부터 발취 
#include "images/options_horizontalbarchart. xpm” 

#include ’’images/options_piechart. xpm” 

#include ’’images/options_verticalbarchart. xpm” 

도표형 복합칸에 사용하려 는 픽 스매 프들을 포함한다 . 

(1) 구성자 

OptionsForm ： ： OptionsForm( QWiget* parent, const char* name, bool 
modal, WFlags f ) 

: QDialog( parent, name, modal, f ) 

{ 

setCaption( "Chart ^ Options" ) ； 
resize( 320, 290 ); 

QDialog 구성자에 인수들을 모두 넘기여 제목과 초기크기를 설정한다 . 

폼의 배 치는 수평칸배 치 관리 자에 도표형표식 자과 복합칸을 가지며 서체단추와 서체 
표식자，그리고 10 진자리수표식자과 스핀칸에서도 비슷하다 . 단추들도 역시 수평배치관 
리자에 배치되지만 그것들을 오른쪽으로 이동하기 위한 수축자가 있다 . 표시값 라지오단 
추들은 틀의 수직칸배 치 관리 자에 배 치된다 . 

optionsFormLayout = new QVBoxLayout( this, 11， 6 ) ； 

모든 창문부품들은 폼의 수직칸배 치관리 자안에 배 치된다 . 

chartTypeLayout = new QHBoxLayout ( 0 ， 0， 6 ) ； 

도표형표식자과 복합칸은 나란히 배치된다 . 
chartTypeTextLabel = new QLabel( " 技 Chart Type", this ) ； 
chartTypeLayout->addWiget ( chartTypeTextLabel ) ； 


chartTypeComboBox = new QComboBox( FALSE, this ) ； 
chartTypeComboBox->insertItem( QPixmap( op 仕 ons 一 piechart ), "Pie Chart” )； 
chartTypeComboBox->insertItem ( QPixmap( options_verticalbarchart ), 
"Vertical Bar Chart” ) ； 

chartTypeComboBox-insertltem ( QPixmap( options_horizontalbarchart ), 
"Horizontal Bar Chart” ) ； 

chartT ypeLayout->addWiget ( chartT ypeComboBox ) ； 
optionsFormLayout->addLayout ( chartT y peLay out ) ； 

도표형표식자를 창조한다 . (후에 도표형복합칸과 관련한 지름건을 준다 .) 또한 도 
표형복합칸을 창조하고 거기에 픽스매프들과 본문을 둘다 채워넣는다 . 그것들을 둘다 수 
평 배 치 관리 자에 추가하고 그 수평 배 치 관리 자를 폼의 수직 배 치 관리 자에 추가한다 . 
fontLayout = new QHBoxLayout( 0, 0, 6 )； 

fontPushButton = new QPushButton( "&Font...this ) ； 
fontLayout->addWiget ( fontPushButton ) ； 

QSpacerltem* spacer = new QSpacerItem( 0, 0, 

QSizePolicy ： : Expanding, QSizePolicy :: Minimum ) ； 
fontLayout -〉 addltem ( spacer ) ； 

fontTextLabel = new QLabel( this )； // Must be set by caller via setFontO 
fontLayout->addWiget ( fontTextLabel ) ； 
optionsFormLayout->addLayout ( fontLayout ) ； 

서 체단추와 서 체표식자를 보유하기 위한 수평칸배 치관리 자를 창조한다 . 서 체단추는 
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단순하다 . 수축자를 추가하여 겉모양을 개선한다 . 현재 사용자가 사용할 서체를 모르므 
로 서체본문표식자는 처음에 비여있다 . 

addValuesFrame = new QFrame( this ) ； 
addValuesFrame->setFrameShape ( QFrame： : StyledPanel ) ； 
addValuesFrame->setFrameShadow ( QFrame :: Sunken ) ； 
addValuesFrameLayout = new QVBoxLayout( addValuesFrame, 11, 6 )； 
addValuesButtonGroup = new QButtonGroup( "Show Values”, 
addValuesF rame ) ； 

addValuesButtonGroup->setColumnLayout(0, Qt： : Vertical ) ； 
addValuesButtonGroup->layout()->setSpacing( 6 ) ； 
addValuesButtonGroup->layout()->setMargin( 11 ); 
addVal uesButtonGroupLayout = new QVBroxLayout ( 
addValuesButtonGroup->layout () ); 

addValuesButtonGroupLayout->setAlignment( Qt： : AlignTop ) ； 


noRadioButton = new QRadioButton( ” &No”, addValuesButtonGroup ) ； 
noRadioButton->setChecked ( TRUE ) ； 

addValuesButtonGroupLayout -〉 addWiget ( noRadioButton ); 

yesRadioButton = new QRadioButton ( "&Yes M , 

addValuesButtonGroup ) ； 

addValuesButtonGroupLayout -〉 addWiget ( yesRadioButton ) ； 

asPercentageRadioButton = new QRadioButton( "As ^Percentage' 
addValuesButtonGroup ) ； 

addValuesButtonGroupLayout->addWiget( asPercentageRadioButton ) ； 
addValuesFrameLayout-〉add 창문부품 ( addValuesButtonGroup ) ； 

사용자는 표식자들을 현시하거나 매개 표식자의 옆에 값들을 그대로 혹은 퍼센트로 
추가하도록 선택할수 있다 . 

틀을 창조하고 그 안에 라지오단추들을 표시하고 그것들의 배치관리자를 창조한다 . 
단추그롭을 창조하여 Qt 가 배타적인 라지오단추의 동작을 자동적으로 조종하게 한다 . 
다음에 라지오단추들을 창조한다 . 이것들은 기정 으로 No 를 가전다 . 

10 진자리수표식자과 스핀칸은 다른 수평배치관리자들처럼 배치되고 단추들은 자료 
설정픔의 단추들과 아주 류사한 방법으로 배치된다 . 


connect ( 

f ontPushButton, 
SLOT( chooseFontO 

SIGNAL ( 

) )； 

clicked () 

), 

this, 

connect ( 

okPushButton, 
SLOT( accept() ) )； 

SIGNAL ( 

clicked () 

), 

this, 

connect ( 

cancel PushButton, 
SLOT( reject() ) )； 

SIGNAL ( 

clicked () 

)， 

this, 


오직 3 개의 련결만 필요하다 . 

① 사용자가 서 체 단추를 찰칵할 때 자체의 chooseFontO 처 리부를 실행 한다 . 

② 사용자가 OK 를 찰칵할 때 QDialog::accept 0 를 호출한다 . 이것은 호출자가 
대화칸의 창문부품들로부터 자료를 읽 어들여 필요한 작용들을 수행 하게 한다 . 

③ 사용자가 Cancel 을 찰칵하면 QDialog: : reject 0 를 호출한다 . 
chartTypeTextLabel->setBuddy ( chartTypeComboBox ) ； 
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decimalPlacesTextLabe 卜〉 setBuddy( decimalPlacesSpinBox ) ； 
setBuddyO 함수를 사용하여 창문부품들을 표식자지름건들과 련결한다 . 

(2) 처 리 부 

void OptionsForm： : chooseFontO 

{ 

bool ok ； 

QFont font = QFontDialog： : getFont( &ok, m_font, this ); 
if ( ok ) 
setFont( font ) ； 

} 

사용자가 Font 단추를 찰칵할 때 이 처리부가 호출된다 . 이것은 단지 정적함수 
QFontDialog: :getFont() 를 호출하여 사용자의 서체선택을 얻는다 . 서체를 선택하였다 
면 서체표식자에 서체의 본문서술을 제시하는 setFontO 처리부를 호출한다 . 
void OptionsForm ： : setFont( QFont font ) 

{ 

QString label = font, family() + ’’’’ + 

QString： : number( font.pointSizeO ) + ”pt’’; 
if ( font, bold() ) 
label += ” Bold”; 
if ( font, italic () ) 
label += ” Italic”; 
fontTextLabel->setText ( label ) ； 
m_font = font ； 

} 

이 함수는 선택한 서체의 본문서술을 서체표식자에 현시하고 m_font 성원에 서체의 
사본을 보관한다 . chooseFontO 에 기정서체를 제공하기 위하여 서체를 성원으로 요구 
한다 . 

9. 프로젝트파일 
/ / chart.pro 
TEMPLATE = app 
CONFIG += warn_on 
REQUIRES = full-config 
HEADERS += element, h \ 
canvastext. h \ 
canvas view, h \ 
chartform.h \ 
optionsform.h \ 
setdataform. h 

SOURCES += element, cpp \ 
canvas view, cpp \ 
chartform.cpp \ 
chartform_canvas. cpp \ 
chartform_files. cpp \ 
optionsform.cpp \ 
setdataform. cpp \ 
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main, cpp 

qmake 를 실행 하여 Makefile 을 생성 한다 . 
qmake -o Makefile chart, pro 


chart 프로그람은 Qt 에 의하여 응용프로그람과 대화칸을 창조하는 간단한 방법을 보 
여준다 . 차림표와 도구띠의 창조는 간단하고 Qt 의 신호-처리부기구는 GUI 사건조종을 
상당히 단순화한다 . 

수동적인 배치관리자창조를 배울 기회가 있을수 있으나 간단한 방법은 QtDesigner 
이다 . QtDesigner 는 단순하지만 강력한 배치도구와 코드편집기를 포함하고있으며 자동 
적 으로 main.cpp 와 .pro 프로젝트파일을 창조한다 . 

앞으로 chart 응용프로그람에 다음의 기능을 실현할수 있다 . 

• QValidator 파생콜라스를 사용하여 오직 유효한 double 들만 값으로 입력될수 있 
도록 담보한다 . 

• 더 많은 도표형 즉 직선그라프，령역그라프와 힐로 (hi-lo ) 그라프의 추가 . 

• 사용자가 우，아래，오른쪽，왼쪽여백을 설정 하게 한다 . 

• 사용자가 표식자과 같이 끌기할수 있는 항목을 지정한다 . 

• 선택항목을 그리고 표식하는 축의 제공 . 

• 표식자대신에 건을 제공하기 위한 선택의 제공 . 

• 모든 도표형들에 3D 형식선택의 추가 . 


제4절. 간단한 응용프로그람 

이 절 에서 는 현대 응용프로그람창문에 서 사용하고있는 클라스들인 QMainWindow, 
QMenuBar, QPopupMenu, QToolBar 및 QStatusBar 의 간단한 사용을 보여준다 . 

또한 QWhatsThis (간단한 방조용)의 몇가지 국면과 QApplication 을 사용하는 전 
형 적 인 main () 을 설 명한다 . 

끝으로 QPrinter 에 기초한 전형적 인 인쇄 함수를 보여준다 . 

1. ApplicationWindow 의 선언 

여기에 완전한 머리부파일이 있다 . 

#ifndef APPLICATION.H 
Sdefine APPLICATION—H 


#include <qmainwindow. h> 
class QTextEdit ； 

class ApplicationWindow : public QMainWindow 

{ 

Q_OBJECT 

public ： 

ApplicationWindow () ； 

^ApplicationWindow () ； 

protected ： 

void closeEvent( QCloseEvent* ) ； 
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private slots ： 
void newDocO ； 
void choose () ； 

void load( const QString 技 fileName ) ； 
void saveO ； 
void saveAs () ； 
void print () ； 

void about () ； 
void aboutQtO ； 

private : 

QPrinter Sprinter ； 

QTextEdit *e; 

QString filename ； 

}； 


#endif 

이것은 QMainWindow 을 계승하며 처리부와 비공개변수들을 가지는 클라스를 선 
언한다 . 선두에서 QTextEdit 의 클라스앞방향선언 ( 머리부대신에)은 를파일속도를 높인 
다 . 이러한 방법으로 make depend 는 qtextedit.h 가 변경될 때 application.il 을 포함하는 
매개의 .cpp 파일의 재를파일을 요구하지 않는다 . 

2. 간단한 main () 

여기에 안전한 main.cpp 이 있다 . 

#include <qapplication. h> 

#include "application. h M 

int main( int argc, char ** argv ) { 

QApplication a( argc, argv ) ； 

ApplicationWindow *mw = new ApplicationWindowO ； 
mw->setCaption( ” Qt Example - Application” ) ； 
mw->show() ； 

a. connect ( 技 a, SIGNAL (lastWindowClosed ()), &a, SLOT (quit ()) ) ； 
return a. exec 0; 

} 

그러면 main, cpp 을 구체적으로 고찰하자 . 
int main( int argc, char ** argv ) { 

QApplication a( argc, argv ) ； 

우의 행에서 보통의 구성자를 가지는 QApplication 객체를 창조하고 argc 와 argv 
를 해석한다 . QApplication 자체는 -geometry 와 같은 XII 에 고유한 지령행추가선택을 
고려 하므로 프로그람은 자동적 으로 X 의 뢰기 들이 바라는대 로 동작한다 . 

App 1 icationWindow *mw = new ApplicationWindowO ； 
mw->setCaption( "Qt Example 一 Application’’ ) ； 
mw- 〉 show() ； 

제 일 웃준위 창문부품으로서 ApplicationWindow 를 창조하고 창문제 목을 
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"Document 1 ’’ 로 설정하고 창문을 표시한다 . 

a. connect( 技 a, SIGNAL (lastWindowClosed()) , 技 a, SLOT (quitO) ) ； 

응용프로그람의 마지막 창문이 닫길 때 완료해야 한다 . 신호와 처리부들은 둘다 
QApplication 의 사전정 의 된 성 원들이 다 . 
return a. exec 0; 

응용프로그람의 초기화를 완성하고 기본사건순환고리 (GUI ) 를 기동하며 우연히 사 
건순환고리를 떠날 때 QApplication 의 오유코드를 돌려준다 . 

} 

3. Applica 付 onWindow 의 실현 

실현파일이 아주 크므로(약 300 행 ) 완전히 렬거하지 않는다 . (원천코드는 
examples/application 등록부에 포함된다 .) 구성자로 기동하기전에 언급할만한 가치가 
있는 3 개의 include 가 있다 . 

#include ” filesave.xpm” 

#include "fileopen.xpm" 

#include ’’fileprint.xpm” 

응용프로그람의 도구단추들은 그림기호들이 없으면 제대로 표시되지 않는다 . 그림 
기호들은 우에서 포함한 XPM 파일들에 있다 . 

App 1 icationWindow :: App 1 icationWindow 0 
: QMainWindow( 0, "example application main window", 
WDestructiveClose | WGroupLeader ) 

{ 

ApplicationWindow 는 차림표띠 , 도구띠 등을 가지는 전형적 인 응용프로그람기본 
창문을 제공하는 Qt 클라스인 QMainWindow 를 계승한다 . 

printer = new QPrinter( QPrinter： : HighResolution ) ； 

응용프로그람실례는 무엇인가 인쇄하고 인쇄시에 사용자가 설정값을 변경할 때 새 
로운 설정이 다음번에 기정으로 되도록 QPrinter 객체를 선택한다 . 

QPixmap openlcon, savelcon, printlcon ； 

실례는 도구띠에 간단히 여러개의 지령들을 가전다 . 우의 변수들은 그 매개에 대하 
여 그림기호를 하나씩 보유한다 . 

QToolBar * fileTools = new QToolBar( this, "file operations" ) ； 

이 창문안에 도구띠를 창조하고 
fileTools->setLabel ( "File Operations" ) ； 

제목을 정의한다 . 사용자가 도구띠를 그 위치밖으로 끌고가서 탁상우에 띄여놓을 
때 도구띠창문은 제목으로서 ’’File Operations ” 를 표시 한다 . 
openlcon = QPixmap ( fileopen ) ； 

QToolButton * fileOpen 

= new QToolButton( openlcon, "Open File”, QString ： ： null, 
this, SLOT (choose ()), fileTools, "open file" ) ； 

이제 적당한 그림기호와 도구암시본문 "Open File ’’ 을 가지는 fileTools 도구띠용 
의 첫 도구단추를 창조한다 . 선두에 포함한 fileopen.xpm 은 fileopen 라고 부르는 픽 
스매프의 정의를 포함한다 . 이 그림기호를 사용하여 첫 도구단추를 설명한다 . 
savelcon = QPixmap ( filesave ) ; 

QToolButton * fileSave = new QToolButton( savelcon, "Save File", 
QString： : null, this, SLOT (save()), fileTools, ’’save file” ) ； 
printlcon = QPixmap ( fileprint ) ； 
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QToolButton * filePrint = new QToolButton( printlcon, "Print File", 
QString： : null, this, SLOT (print ()), fileTools, ” print file” ); 
비슷한 방법으로 도구띠에 두개의 도구단추를 더 창조한다 . 매개가 적당한 그림기 
호들과 도구암시본문을 가전다 . 3 개의 단추는 모두 이 객체의 적당한 처리부들에 련결 
된다 . 실례로 "Print File ’’ 단추는 ApplicationWindow: : print 0 에 련결된다 . 

(void) QWhatsThis :: whatsThisButton ( fileTools ) ； 

도구띠의 4 번째 단추는 ’’What’s This ?” 방조를 제공한다 . 그 마우스대면부가 보통 
과 다르므로 특수한 함수를 리용하여 설정되여야 한다 . 

const char * fileOpenText = ”<p〉<img source=\”fileopen\"> ’， 

"Click this button to open a <em〉new file</em>. <br>" 

” You can also select the <b>Open</b> command ，’ 

"from the <b>File</b> menu. </p>"； 

QWhatsThis::add( fileOpen, fileOpenText ) ； 

우의 행에서 fileOpen 단추에 ” What’s This ?” 방조본문을 추가하고 
QMimeSourceFactory :: defaultFactory() - >setPixmap( ’’fileopen", openlcon )； 

방조본문 (fileOpenText 에 보관한것처럼)이 ’’fileopen ’’이라는 이름의 화상을 요구 
할 때 openlcon 픽스매프가 사용된다는것을 리치본문엔진에 알린다 . 

const char * fileSaveText = ’’<p〉Click this button to save the file you ” 
"are editing. You will be prompted for a file nameAn" 

” You can also select the <b>Save</b> command ” 

” from the <b>File</b> menu.</p〉’’; 

QWhatsThis： ：add( fileSave, fileSaveText ) ； 

const char * filePrintText = "Click this button to print the file you 
are editing. \n” ” You can also select the Print command from the File 
menu. "； 


QWhatsThis::add( filePrint, filePrintText ) ； 

나머지 두개 단추의 "What’s This ?” 방조는 픽스매프를 사용하지 않으므로 단추에 
방조본문을 추가하여 야 한다 . 

주의 : fileSaveTextO 에서 리치본문요소들을 호출하기 위하여 전체문자렬은 <p > 와 
</p > 에의해 둘러막아야 한다 . filePrintText 0 는 리치본문요소들을 가지지 않으므로 
이것은 필요없다 . 

QPopupMenu * file = new QPopupMenu( this ) ； 
menuBar()->insertltem( ” &File’’，file ) ； 

다음으로 File 차림표용의 QPopupMenu 을 창조하여 차림 표띠 에 추가한다 . 문자 F 
앞에 & 를 불이면 사용자가 지름건 Alt+F 을 사용하여 차림표를 펼칠수 있다 . 

file - 〉 insertltem( " 技 New”, this, SLOT(newDoc()), CTRL+Key_N ) ； 

그 첫 항목이 처 리부 newDocO 에 련결된다.(아직 실현되지 않는다 .) 사용자가 이 
New 항목을 선택하거나 (실례로 &표식된 문자 N 을 입력하여 ) Ctrl+N 지름건을 사용하 
면 새로운 편집기창문이 펼쳐진다 . 
int id ； 

id = file->insertltem( openlcon, "&Open... M , this, SLOT (choose0), 
CTRL+Key.O ) ； 

file->setWhatsThis ( id, fileOpenText ) ； 
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id = file->insertltem( savelcon, "&Save M , this, SLOT (save ()), 
CTRL+Key_S ) ； 

file->setWhatsThis ( id, fileSaveText ) ； 

id = file->insertltem( "Save 技 As...’’, this, SLOT (saveAs 0) ); 

file->setWhatsThis ( id, fileSaveText ) ； 

File 차림표를 3 개의 지 령들 (Open, Save 그리고 Save As) 로 채우고 그것들에 대 
하여 ” What’s This?” 방조를 설정한다 . 특히 ” What’s This?" 방조와 픽스매프들은 도 
구띠와 차림표띠에서 둘다 사용된다 . (QAction 과 《 Qt 실례프로그람 》 의 
examples/action 실 례 를 참고 . ) 

file -〉 insertSeparatorO ； 

그다음 분리선을 삽입하고 

id = file->insertltem ( print Icon, ” &Print...’’, this, SLOT (print ()), 

CTRL+Key_P )； 

file->setWhatsThis ( id, filePrintText ) ； 


file -〉 insertSeparatorO ； 

file - 〉 insertltem( ” &Close M , this, SLOT (close0), CTRL+Key_W ) ； 
file->insertltem( ” &Quit”, qApp, SLOT( closeAl 1 Windows () ), 

CTRL+Key_Q ); 

’’What’s This ?” 방조를 가지는 Print 지령，또 하나의 분리선， ” What’s This ?" 와 
픽스매프들이 없는 2 개의 지령을 삽입한다 . Close 지령의 경우에 신호는 각각의 
ApplicationWindow 객체의 close() 처리부에 련결되고 Quit 지령은 전체 응용프로그 
람에 영향을 준다 . 

ApplicationWindow 는 QWidget 이므로 close () 함수는 후에 실현하는 

closeEvent 0 에로의 호출로 절환한다 . 
menuBar () ->insertSeparator () ； 

File 차림표를 실현하였으므로 초점을 차림표띠로 옮기고 분리선을 삽입한다 . 이제 
부터 앞으로 차림표띠항목들은 창문체계형 식 이 요구한다면 오른쪽에 배 치된다 . 
QPopupMenu * help = new QPopupMenu( this ) ； 
menuBar()->insertltem( ’’ 技 Help", help ); 

help->insertltem( ，， & About，，, this, SLOT (about 0) ， Key.Fl )； 
help->insertltem( "About 技 Qt”, this, SLOT(aboutQt()) ) ； 
help->insertSeparator () ； 

help->insertltem ( "What’s &This M , this, SLOT (whatsThis ()), 

SHIFT+Key_Fl )； 

Help 차림표를 창조하여 차림표띠에 추가하고 여러개의 지령을 삽입한다 . 형식에 
따라서 지령들은 차림표띠의 오른쪽에 나타난다 . 
e = new QTextEdit( this, "editor" ) ； 
e->setFocus() ； 
setCentralWidget ( e ) ； 

이제 하나의 본문편집기를 창조하고 처음의 초점을 그것에 설정하고 창문의 중심창 
문부줌으로 만든다 . 

QMainWindow: : central Widget 0 는 전체 응용프로그람의 심장부이 다 . 거기에 차 
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림표띠，상래띠，도구띠들이 모두 배렬된다 . 중심창문부품이 본문편집할수 있는 창문부 
품이 므로 우리 의 응용프로그람은 간단한 본문편집 기 이 다 . 
statusBar() - >message( ” Ready”, 2000 ) ； 

상태띠가 기동시에 2s 동안 Ready 를 표시하여 사용자에게 그 창문이 초기화를 끝냈 
으며 사용가능하다는것을 알리게 한다 . 
resize ( 450，600 ) ； 

끝으로 새로운 창문의 크기를 기정크기로 조절한다 . 

} 

구성 자를 끝내고 해체 자를 설명한다 . 

ApplicationWindow :: ^ ApplicationWindow () 

{ 

delete printer ； 

} 

ApplicationWindow 창문부품이 해체자에서 해야 할 유일 한 일은 그것이 창조한 
인쇄기를 삭제하는것이다 . 다른 모든 객체들은 적당한 시각에 Qt 가 삭제하는 자식창문 
부품들을 가전다 . 

이제는 머리 부파일에서 언급하고 구성자에서 사용한 처리 부들을 모두 실현하는것이다 . 
void ApplicationWindow： : newDocO 
{ 

ApplicationWindow *ed = new ApplicationWindow ； 
ed- 〉 setCaption(’’Qt Example - Application’’); 
ed->show() ； 

} 

File|New 차림표항목에 련결된 이 처리부는 단순히 새로운 ApplicationWindow 를 
창조하고 표시한다 . 

void ApplicationWindow ： : choose() 

{ 

QString fn = QFileDialog ： : getOpenFileName( QString ： : null, 

QString ： ： null, this) ； 

if ( Ifn.isEmptyO ) 
load( fn ) ； 
else 

statusBar() - 〉 message( "Loading aborted", 2000 ) ； 

} 

choose 0 처리부는 Open 차림표항목과 도구단추에 련결된다 . 

QFileDialog: :getOpenFileName() 로부터의 약간한 방조에 의하여 사용자에게 파일이 
름을 묻고 그다음 그 파일을 적재 하거 나 상태띠 에 오유통보를 준다 . 

void ApplicationWindow :: load ( const QString 技 fileName ) 

{ 

QFile f ( fileName ) ； 
if ( !f.open( IO_ReadOnly ) ) 
return ； 

QTextStream ts( 技 f ) ； 
e->setText( ts.readO ); 
e->setModified( FALSE ); 
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setCaption ( fileName ) ； 

statusBarO - 〉 message( "Loaded document ” + fileName, 2000 ) ； 

} 

이 함수는 편집기에 파일을 적재한다 . 그것을 수행하면 창문체계제목을 파일이름으 
로 설정하고 상태띠에 약 2s 동안 성공통보를 현시한다 . 존재하지 않지만 읽을수 없는 
파일들에 의하여 어떤 일도 생기지 않는다 . 
void ApplicationWindow： : saveO 
{ 

if ( filename. isEmpty() ) { 
saveAsO ； 
return ； 


QString text = e->text() ； 

QFile f ( filename ) ； 

if ( !f.open( IO_WriteOnly ) ) { 

statusBarO->message( QString( M Could not write to % 1 11 ).arg(filename), 
2000 )； 
return ； 

} 

QTextStream t( &f )； 
t « text ； 
f.closeO ； 

이름을 제안할 때 함수는 현재 파일을 보관한다 . 지금까지 파일이름이 지정되지 않 
았으면 saveAsO 함수가 호출된다 . 써넣을수 없는 파일들은 ApplicationWindow 객체 
가 상태띠에 오유통보를 제공하게 한다 . 이것을 수행하는 방법이 하나이상 있다 . 우의 
statusBarO -〉 messageO 행을 loadO 함수의 등가한 코드와 비교할수 있다 . 
e->setModified( FALSE ); 

편집기에서 마지막으로 보관한 다음 내용을 편집하지 않았다는것을 알린다 . 사용자 
가 더 편집하고 명백히 보관하지 않고 창문을 담으려고 할 때 
ApplicationWindow: :closeEvent 0 가 보관하겠는가 묻는다 . 
setCaption ( filename ) ； 

문서가 낡은 제목이 아닌 다른 이름으로 보관될수 있으므로 창문제목을 확인하도록 
설정 한다 . 

statusBarO- 〉 message( QString( "File %1 saved' 1 ).arg( filename ), 2000 )； 

} 

상태띠의 통보를 리용하여 사용자에게 그 파일이 성공적으로 보관되였다는것을 통 
보한다 . 

void ApplicationWindow： : saveAsO 

{ 

QString fn = QFileDialog ： : getSaveFileName( QString ： : null, 

QString ： ： null, this ) ； 

if ( !fn. isEmpty() ) { 
filename = fn ； 
saveO ； 


91 




} else { 

statusBarO - 〉 message( ’’Saving aborted", 2000 ) ； 


이 함수는 새 이름을 묻고 그 이름으로 문서를 보관하고 창문체계제목을 새 이름으 
로 암시적으로 변경한다 . 

void ApplicationWindow： : print () 

{ 

printer - 〉 setFullPage( TRUE ) ； 
if ( printer->setup (this) ) { // printer dialog 

statusBarO - 〉 message( "Printing..." ) ； 

QPainter p ； 

if ( !p. begin( printer ) ) { // paint on printer 

statusBarO- 〉 message( ’’Printing aborted", 2000 ) ； 
return ； 

} 

QPaintDeviceMetrics metrics ( p. device() ) ； 
int dpiy = metrics. logicalDpiY() ； 

int margin = (int) ( ( 2 / 2 . 54)*dpiy ) ； // 2 cm margins 
QRect view( margin, margin, metrics, width () - 2*margin, 

metrics, height() 一 2*margin ) ； 

QSimpleRichText richText( QStyleSheet： : convertFromPlainText (e- 
>text 0), QFont 0, e->context 0, e-〉sty leSheet 0, e->mimeSourceFactory (), 
view, height () ) ； 

richText. setWidth ( 技 p, view, width () ) ； 
int page = 1 ； 
do { 

richText.draw( 技 p, margin, margin, view, colorGroupO ); 
view.moveBy( 0, view, height() ) ； 
p. translate( 0 , -view, height () ) ； 
p.drawText( view. rightO 

p. fontMetrics (). width ( QString： : number ( page ) ), 

view, bottom () + p. fontMetrics (). ascent () + 5, 

QString ： : number( page ) ) ； 

if ( view, top() - margin >= richText. height () ) 
break ； 

printer->newPage () ； 
page ++； 

} while (TRUE) ； 

statusBarO_ 〉 message( ” Printing completed”, 2000 ); 

} else { 

statusBarO - 〉 message( "Printing aborted", 2000 ) ； 


} 
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print0 는 File | Print 차림표항목과 filePrint 도구단추에 의해 호출된다 . 

사용자에 게 인쇄 설정 대 화칸을 현시 하고 취 소하면 인쇄 를 무시 한다 . 

QSimpleRichText 객체를 창조하고 거기에 본문을 준다 . 이 객체는 본문을 하나의 
긴 폐지로서 형식화할수 있다 . QSimpleRichText 폐지로부터 한폐지의 본문을 한번에 
출력하여 폐지번호를 엄는다 . 

이제는 사용자가 ApplicationWindow 를 닫으려고 할 때 어떤 현상이 생기는가를 
고찰한다 . 

void ApplicationWindow ： : closeEvent( QCloseEvent* ce ) 

{ 

이 사건은 창문체계닫기사건들을 처리하여 엄는다 . 닫기사건은 은폐사건과 다르며 
흔히 은폐는 최소화를 의미하고 닫기는 창문이 사라지는것을 의미한다 . 
if ( !e->isModified() ) { 
ce->accept() ; 
return ； 

} 

본문이 편집되지 않았으면 그 사건을 받아들인다 . 창문은 닫겨지고 
Applica 吐 onWindowO 구성 자에서 WDestructiveClose 창문부품기 발을 사용하였으므로 
창문부품이 삭제된다 . 

switch( QMessageBox ： : information( this, "Qt Application Example", 

"Do you want to save the changes to the document?", 

"Yes", "No", "Cancel", 0, 1 ) ) { 

그렇지 않으면 사용자에게 무엇을 하려고 하는가고 묻는다 . 
case 0 ： 
saveO : 
ce->accept 0 ; 
break ； 

보관하고 완료하려 고 한다면 그것을 수행 한다 . 
case 1: 
ce->accept() : 
break ； 

사용자가 완료하려고 하지 않으면 닫기사건을 무시한다 . (그것을 차단할수 없는 경 
우가 있다 .) 

case 2 ： 

default ： // just for sanity 
ce->ignore() : 
break ； 

마지막 경우 즉 사용자가 편집을 무시하고 완료하려고 하는 경우에는 아주 간단하다 . 


끝으로 방조차림 표항목들이 사용할 처 리부들을 실현한다 . 
void ApplicationWindow ： : about() 

{ 

QMessageBox ： : about( this, "Qt Application Example", 
"This example demonstrates simple use of 
"QMainWindow, XnQMenuBar and QToolBar. ")； 

} 
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void ApplicationWindow :: aboutQtO 


QMessageBox ： : aboutQt( this, M Qt Application Example 1 ' ) ； 

} 

이 두개의 처 리부는 준비된 about 함수들을 사용하여 이 프로그람과 그것 이 사용하 
는 GUI 도구일식에 대한 정보를 제공한다 . 
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제 3 장. Qt 객체모형 


제1절. Qt 객체모형 

표준 C++ 객체모형은 객체원형을 위한 매우 효과적인 실행시지원기능을 제공한다 . 
그러나 C++ 객체모형의 정적특성은 일정한 문제령역에서 유연성이 없다 . 도형방식사용자 
대면부프로그람작성은 실행시효률과 높은 수준의 유연성을 둘다 요구하는 령역이다 . Qt 
는 Qt 객체모형의 유연성과 함께 C++ 의 속도를 결합함으로써 이것을 제공한다 . 

Qt 는 C++ 에 다음의 특성들을 추가한다 . 

• 신호，처 리부라고 부르는 원만한 객 체통신을 위한 매우 강력한 기구 

• 질문 및 설 계 가능한 객 체 속성 들 

• 강력 한 사건들과 사건 려 과기 들 

• 국제 화를 위 한 문맥 문자렬 번 역 

• 사건구동형 GUI 에서 많은 과제들을 훌륭히 통합할수 있게 하는 복잡한 시격구동 
형시계들 

• 본래의 방법 으로 객체소유를 조직하는 계층적 이고 질문가능한 객체 나무 

• 감시 (guarded) 지적자 QGuardedPtr 들은 참고된 객체가 해체되면 자동적으로 0 
으로 설정되지만 표준 C ++지적자들은 객체가 해체되면 《 속박지적자 (dangling 
pointer) 》로 된 다 

어에서 이러한 대부분의 특징들은 QObject 로부터 계승에 기초한 표준 C++ 기술에 
의해 실현된다 . 객체통신기구와 동적속성체계와 갈은 다른것들은 Qt 자체의 메타객체를 
파일러 (moc) 에 의해 제공되는 메타객체체계를 요구한다 . 

메타객체체계는 언어가 부분품 GUI 프로그람작성에 적합하게 한다 . 형판을 C++ 확장 
에 사용할수 있지만 메타객체체계는 형판로 실현되지 않는다 (6 절 참고 ). 


제2절. 객체나무와 객체소유자 

QObject 들은 그 자체를 객체나무로 조직화한다 . 다른 객체를 부모로 하여 
QObject 를 창조할 때 그것은 부모의 children 0 목록에 추가되고 부모가 있을 때 삭제 
된다 . 이 수법은 GUI 객체들의 요구를 아주 충분히 만족시킨다 . 실례로 QAccel (건반지 
름건)은 관련한 창문의 자식 이므로 사용자가 창문을 닫을 때 지름건도 삭제된다 . 

정적함수 QObject::objectTrees() 는 현재 존재 하는 뿌리객체 모두에로의 접근을 
제공한다 . 

화면에 나타나는 모든것의 기초콜라스 QWidget 는 부모-자식관계를 확장한다 . 자식 
은 보통 자식창문부품으로도 된다 . 즉 그것은 부모의 자리표계에 현시되고 부모의 경계 
에 외해 그라프적으로 갈타진다 . 실례로 응용프로그람이 닫긴 후에 통보창을 삭제할 때 
통보창의 단추와 표식자들도 삭제된다 . 그것은 단추와 표식자들이 통보창의 자식이기때 
문이다 . 

또한 자식객체들을 자체로 삭제하면 부모들로부터 스스로 삭제된다 . 실례로 사용자 
가 도구 띠 를 삭제할 때 응용프로그람이 QToolBar 객 체 들중 하나를 삭제 할수 있 다 . 그 
경우에 도구 띠의 QMainWindow 부모는 변경을 탐지하고 그 화면공간을 재구성한다 . 

오유수정 함수 QObject: :dumpObjectTree() 와 QObject :: dumpObjectlnfoO 는 
흔히 응용프로그람이 이상하게 보이거나 동작할 때 사용할수 있다 . 
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제 3 절. 신호와 처리부 

신호와 처리부는 객체들사이 통신에 사용된다 . 신호-처리부기구는 Qt 의 중요한 특 
징이며 다른 도구묶음 (toolkit ) 과 가장 크게 차이 나는 부분이 다 . 

GUI 프로그람작성에서는 자주 한 창문부품에서의 변화를 다른 창문부품에 통보할것 
을 요구한다 . 더 일반적으로는 서로 통신할수 있는 임의의 종류의 객체들을 요구한다 . 
례들어 XML 파일을 해석한다면 새 꼬리표를 만날 때마다 XML 파일구조를 표시하는데 
사용하고있는 목록보기에 통지하려고 한다 . 

낡은 도구묶음은 역호출에 의하여 이 런 형 태의 통신을 진행 한다 . 역 호출은 함수의 
지적자이므로 처리함수가 어떤 사건에 대해 통보하려고 하면 다른 함수의 지적자를 처리 
함수에 넘 긴다 . 처 리 함수는 그다음 적 당한 역 호출기 능을 호출한다 . 역호출은 두가지 기 
본결함이 있다 . 첫째로 , 형안전하지 못하다 . 처리함수가 정확한 인수들을 가지고 역호출 
기능을 호출하는지 확신할수 없다 . 둘째로，처리함수는 어느 역호출이 호출되는지 알아 
야 하기때문에 역호출기능은 처리함수에 강하게 의존된다 . 



그림 3-1. 신호와 처리부련결의 추상화 


Qt 에서는 역호출기술대신 신호와 처리부를 사용한다 . 신호는 특별한 사건이 발생하 
면 발생된다 . Qt 의 창문부품들은 미리 정의된 신호들을 많이 가지고 있지만 항상 파생 
콜라스를 추가할수 있다 . 처 리부는 특별한 신호에 응답하여 호출되는 함수이다 . Qt 의 
창문부품들은 미리 정의된 처리부를 많이 가지고있지만 실천에서는 일반적으로 자기가 
관심을 가지는 신호들을 조종할수 있게 자체의 처 리부들을 추가한다 . 

신호-처리부기구는 형안전하다 . 신호의 서명은 받는측 처리부의 서명과 어울러야 
한다 . (사실상 처리부는 받는 신호보다 더 짧은 서명을 가전다 . 왜냐하면 여유인수를 무 
시할수 있기때문이다 .) 서명들은 서로 호환되므로 를파일러가 형오유를 찾는데 도움이 
될수 있다 . 신호와 처리부는 약하게 결합된다 . 신호를 발생하는 콜라스는 어느 처리부가 
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신호를 받는지 모르며 관심하지도 않는다 . Qt 의 신호-처리부기구는 처리부에 신호를 련 
결 (connect) 하면 처 리부가 적 당한 시 간내 에 신호의 파라메터 들을 가지 고 호출된다는것 
을 담보한다 . 신호와 처러부들은 임의의 형의 임의의 수의 인수를 가질수 있고 완전히 
형 안전하므로 더 이상 역호출올 론의 할 필요가 없다 . 

QObject 혹은 그 파생클라스들의 하나로부터 계승되는 모든 들라스(례들어 
QWidget) 들은 신호와 처리부를 포함할수 있다 . 신호는 바깥세계에 관심을 가질수 있도 
록 객체들의 상태를 변화시킬 때 객체들에 의하여 발생된다 . 이것은 객체들이 통신하게 
한다 . 발생하는 신호들을 어느것이 받는지 모르며 관심하지도 않는다 . 이것은 진짜 정보 
은폐 이 며 객체 가 쏘프트웨 어 부분품으로 사용될수 있 다는것 을 담보한다 . 


connect) fontFamilyComboBox, activated(QString), 
textEdit, setFamily(QString)) 



그림 3-2. 신호와 처리부련결의 실례 

처리부는 받아들이는 신호에 사용될수 있는 보통성원함수들이다 . 객체가 자기 신호 
를 어떤것이 받는지 모르는것처럼 처리부는 자기에게 어떤 신호가 련결되였는지 모른다 . 
이것은 Qt 에 의하여 참말로 독립적인 부분품들을 창조할수 있게 한다 . 

한개의 처리부에 요구되는것만큼 많은 신호를 련결할수 있으며 한개 신호를 요구되 
는 수많은 처 리부들에 련결할수 있다 . 한개 신호를 다른 신호에 직접 련결하는것도 가 
능하다 . (이것은 첫 신호가 발생될 때마다 두번째 신호가 즉시 발생된다 .) 

이와 함께 신호와 처 리부는 강력한 부분품프로그람작성기술도 제공한다 . 

1. 간단한 실례 

다음과 같이 아주 작은 C++ 들라스선언부를 쓴다 . 
class Foo 
{ 

public ： 

Foo ()； 

int value 0 const { return val ； } 
void setValue ( int ) ； 
private ： 
int val ； 

}； 

작은 Qt 콜라스를 다음과 같이 쓴다 . 
class Foo : public QObject 
{ 

Q—OBJECT 

public ： 
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FooO ； 

int value 0 const { return val ； } 
public slots ： 
void setValue( int ); 
signals ： 

void valueChanged( int ) : 
private ： 
int val ； 

}； 

이 들라스는 같은 내부상태와 그리고 상태에 접근하는 공개메쏘드를 가진다 . 그러 
나 그밖에도 신호와 처리부에 의한 부분품프로그람작성에 대한 지원도 가전다 . 이 들라 
스는 신호 valueChangedO 를 발생하여 상태가 변화되였다는것을 외부세계에 알릴수 
있으며 다른 객체들이 신호들을 보낼수 있는 처리부를 자진다 . 

신호나 처리부를 가지는 모든 콜라스는 자기 선언부에 Q_OBJECT 를 서술해 야 한다 . 

처리부는 응용프로그람작성자에 의해 실현된다 . 여기에 Foo::setValue() 의 가능한 
실현부가 있다 . 

void Foo： : setValue( int v ) 

{ 

if (v != val ) { 
val = v ； 

emit valueChanged(v); 

} 

} 

emit valueChanged(v) 행은 객체로부터 신호 valueChanged 를 발생시킨다 . 알 
수 있는것처럼 emit signal ( 인수)를 리용하여 신호를 발생한다 . 

여기에 두개의 객체들을 서로 련결하는 방법이 있다 : 

Foo a, b ； 

connect (&a, SIGNAL (valueChanged (int)), &b, SLOT (setValue (int))); 
b. setValue( 11 ) ； // a == undefined b == 11 

a. setValue ( 79 ) ； // a == 79 b == 79 

b. value 0; // returns 79 

a. setValue(79) 호출은 a 가 valueChangedO 신호를 발생 하게 하고 b 를 자기의 
setValueO 처리부에 받아들인다 . 즉 b.setValue(79) 가 호출된다 . b 는 그다음 같은 
valueChangedO 신호를 발생하면 건의 valuecgangedO 신호에 련결된 처리부가 없기 
때문에 아무것도 발생되지 않는다 . (신호는 없어진다 .) 

setValueO 함수는 값을 설정하며 v!=val 일 때에만 신호가 발생된다 . 이것은 순환 
련결인 경우 무한순환을 막는다 . (례들어 b. valueChangedO 가 a.setValueO 에 련결 
되였을 때 ) 

신호는 자기가 만드는 매개 련결에 대하여 발생되므로 련결이 중복되면 두 신호가 
발생된다 . QObject: : disconnect 0 에 의 하여 항상 련결을 없앨수 있다 . 

이 실례는 누군가가 처음에 객체들사이에 련결을 설정하였으면 그것들이 서로 모르 
고 작업할수 있 다는것 을 설 명 한다 . 

름파일 러 가 표준 C++ 로 제 시할수 있도록 앞처 리 프로그람은 signal 과 slot, emit 예 
약어를 변화시키거나 삭제한다 . 

신호와 처리부를 포함하고있는 클라스선언부에서 moc 를 실행한다 . 이것은 응용프 
로그람용으로 다른 목적파일들과 함께 름파일되거나 련결되여야 하는 C ++ 원천파일을 생 
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성한다. qmake 를 사용한다면 moc 를 자동호출하기 위한 makefile 규칙들이 자기의 
makefile 에 추가된다. 

2. 신호 

신호는 객체의 의뢰기 혹은 소유자에 관심이 있도록 객체의 초기상태가 변화되였을 
때 객체에 의해 발생된다. 신호를 정의하는 콜라스와 그 파생콜라스들만이 신호를 발생 
할수 있다. 

실례로 목록칸은 clickedO 와 currentChangedO 신호를 둘다 발생한다. 거의 모 
든 객체들은 아마도 사용자가 항목을 마우스로 누르거나 방향건으로 이동할 때마다 현재 
목록항목을 주는 currentChangedO 에만 관심을 가진다. 그러나 일부 객체들은 어느 
항목이 선택 되 였는가만 알려 고 한다. 신호가 두개의 서 로 다른 객체 들과 관련되 여있으 
면 두 객체의 처리부들에 신호를 련결한다 

신호가 발생되면 그에 련결된 처리부는 보통 함수호출 때와 같이 즉시 실행된다. 
신호-처 리 부기 구는 어 떤 GUI 사건순환고리 와도 완전독립이 다. 모든 처 리 부들이 되 돌아 
갈 때 emit 도 되돌아간다. 

여러개의 처리부들이 한 신호에 련결되면 신호가 발생될 때 처리부들은 임의의 순 
서로 하나씩 실행된다. 

신호들은 자동적으로 moc 에 의해 생성되므로 . cpp 파일에서 실현하지 말아야 한다. 
그것들은 절대로 돌림값형을 가질수 없다. 즉 void 를 사용한다. 

인수에 대한 알아두기: 경험은 신호와 처리부가 특별한 형을 사용하지 않으면 그것 
들을 재리용할수 있다는것을 보여준다 . QScrollBar :: valueChanged () 가 가정적인 
QRangeControl :: Range 와 같은 특수형을 사용하면 이것은 QRangeControl 을 위 해 
특별히 설계된 처리부들에만 련결될수 있다. 

3. 처리부 

처리부는 거기에 련결된 신호가 발생될 때 호출된다. 처리부는 보통 C ++ 함수들처럼 
호출할수 있으며 그 유일한 특징은 신호를 처리부에 련결할수 있다는것이다. 처리부의 
인수는 기정값을 가질수 없으며 신호와 같이 처리부인수로서 자체의 사용자정의형을 사 
용하는것은 드물다. 

처리부들은 좀 추가적인 특성을 가지는 보통 성원함수들이므로 일반성원함수들과 
같은 호출권을 가전다. 처리부의 호출권 (access right ) 은 거기에 무엇을 련결할수 있 
는가 결정 한다. 

공개처리부는 신호와 련결할수 있는 처리부를 포함한다. 이것은 부분품프로그람작 
성에 매우 유리하며 서로 모르는 객체들을 창조하고 정보가 정확히 넘어가도록 신호와 
처 리 부들을 련결 하고 투입 하고 실 행 한다. 

보호처리부는 이 콜라스와 파생콜라스들이 신호를 련결할수 있는 처리부를 포함한 
다. 이것은 외부세계에 대한 대면부보다도 콜라스의 실현부를 이루는 처리부들에 해당한 
것 이 다. 

비공개처리부는 오직 콜라스자체가 신호들을 련결할수 있는 처리부들을 포함한다. 
이것은 매우 단단히 련결된 클라스들을 위한것이며 여기서는 파생콜라스들이 옳게 련결 
되였는지 알수 없다. 

또한 처리부도 가상으로 정의할수 있으며 이것은 실천에서 아주 유리하다. 

신호-처리부기구는 효과적이지만 역호출처럼 빠르지 못하다. 신호와 처리부는 그것 
들이 제공하는 유연성의 증가로 인하여 현저하게 느리지만 실제의 응용프로그람들에서 
그 차이는 중요하지 않다. 일반적으로 일부 처리부들에 련결되는 신호의 발생은 비가상 
함수호출을 가지고 직접 수신자들을 호출하는것보다 10배정도 더 느리다. 이것은 련결 
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객체를 찾기 위하여, 모든 련결을 안전하게 순환하기 위하여 (즉 다음의 수신자들이 발 
생시에 해체되지 않았는가를 검사하면서) 그리고 일반적인 방식으로 파라메터들을 조립 
하기 위하여 요구되는 추가비용이 다. 10개의 비가상함수호출이 많아보이지만 new 혹은 
delete 연산보다 비용이 훨씬 적다. 배경에서 new 혹은 delete 를 요구하는 string, 
vector 혹은 list 조작을 수행할 때 신호와 처리부들의 추가비용은 완전함수호출비의 극 
히 작은 비률에 대응된다. 이것은 처리부에서 체계호출을 수행할 때나 10개이상의 함수 
들을 간접호출할 때 나 마찬가지 이 다. i586-500 에 서 매 초마다 한개 의 수신자에 련결된 
약 2,000,000개 의 신호를 발생할수 있으며 매 초마다 두개 의 수신자에 련결된 약 
1,200,000개 신호를 발생할수 있 다. 

4. 메타객체정보 

메 타객 체름파일 러 ( moc ) 는 C++ 파일에서 콜라스선언을 해석 하고 메 타객체 를 초기화 
하는 C++ 코드를 생 성한다. 메 타객 체 는 이 함수들의 지 적 자뿐아니 라 모든 신호와 처 리부 
성원들의 이름들을 포함한다. 

메타객체는 객체의 들라스이름과 같은 추가정보를 포함한다. 례들어 객체가 특정한 
콜라스를 계승하는가 검사할수도 있다. 

if ( widget->inherits("QButton") ) { 

// yes, it is a push button, radio button etc. 

} 

5. 리상적인 실례 

여기에 간단한 실례가 있다. 

// qlcdnumber. h 로부터 발취 
#include "qframe. h" 

#include "qbitarray. h" 

class QLCDNumber : public QFrame 

QLCDNumbei •는 QObject 를 계 승하는데 여기에는 QFrame 과 Q Widget, 
#include 의 관련한 선언들을 거처 신호-처리부지식을 모두 포함한다. 

{ 

Q—OBJECT 

Q_QBJECT 는 moc 에 의해 실현되는 여러 성원함수들을 선언하기 위하여 앞처리기 
에 의 해 전개된다. 《virtual function QButton： : className not defined》 라는 콤파 
일러오유를 엄으면 moc 실행을 잊었거나 link 지령에서 moc 출력을 포함하지 않았다는것 
을 의미한다. 
public： 

QLCDNumber( QWidget *parent=0, const char *name=0 ); 

QLCDNumber( uint numDigits, QWidget *parent=0, const char 
*name=0 ) : 

moc 와 명백히 관련되지 않지만 QWidget 를 계승하면 거의 확정적으로 구성자들에 
서 와 인수를 가지려고 하며 부모의 구성자에 그것들을 넘기려고 한다. 

일부 해체자와 성 원함수들은 여 기서 생 략한다. moc 는 성 원함수들을 무시한다. 
signals： 

void overflow () : 

QLCDNumber 는 불가능한 값을 현시할데 대 한 요구를 받았을 때 신호를 발생한다. 

자리넘침에 주의를 돌리지 않거 나 자리넘침이 발생할수 없다는것을 알게 되면 자리 
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넘침신호를 무시할수 있다. 즉 어떤 처 리부에도 그것을 련결하지 않는다. 

다른 한편 수의 자리넘침 이 있을 때 2개의 서로 다른 오유함수를 호출하려고 한다 
면 2개 다른 처리부에 그 신호를 간단히 련결한다. Qt 는 임의의 순서로 둘다 호출한다. 


public 

slots ： 


void 

display ( int nun 

)； 

void 

display ( double 

num ) ； 

void 

display ( const char *str ) ； 

void 

setHexModeO ； 


void 

setDecModeO ； 


void 

setOctModeO ； 


void 

setBinModeO ； 


void 

smal IDecimalPoint ( bool ) ； 


처리부는 수신함수이며 다른 창문부품들에서의 상태변화에 대한 정보를 얻는데 사 
용된 다. QLCDNumber 는 우에 서 보여 주는 코드와 같이 처 리 부를 사용하여 현시할 수 
값을 설정한다. displayO 는 프로그람의 클라스대 면부이 므로 처 리 부는 공개 이다. 

여러개의 실례프로그람은 displayO 처리부에 QScrollBar 의 newValueO 신호를 
련결하므로 LCDNumber 수값은 련속적으로 흘림띠의 값을 표시한다. 

displayO 는 재정의되면 Qt 는 처리부에 신호를 련결할 때 적당한 판을 선택한다. 
역호출과 함께 5가지 서로 다른 이름들을 찾아야 하며 자체로 형들의 궤적을 보관해야 
한다 

일부 관계없는 성원함수들은 이 실례에서 설명하지 않는다. 


제4절. 메타객체체계 

어의 메 타객 체 체 계 (Meta Object System ) 는 객 체 내 통신，실 행 시 형 정 보，동적 속성 
체 계 를 위 한 신호-처 리부기 구를 제 공한다. 

메타객체체계는 다음의 3가지에 기초한다. 

① QObject 콜라스， 

② 콜라스선언의 비공개부안에 있는 Q _ OBJECT 마크로， 

遊) 메 타객 체 콤파일 러 (Meta Object Compiler ) moc . 

■는 C ++ 원천파일을 읽어 들인다. Q _ OBJECT 마크로를 포함하는 하나이상의 들라 
스선언을 찾으면 Q _ OBJECT 마크로를 포함하는 들라스들을 위한 메 타객 체 코드를 포함 
하는 또 다른 C ++ 원천파일을 생성한다. 이렇게 생성된 원천파일은 클라스의 원천파일에 
포함되거나 들라스의 실현시에 를파일되고 련결된다. 

객체 들사이의 통신을 위한 신호-처 리부기구를 제공하는것(기 본리 유는 체 계를 받아 
들이기 위하여)과 함께 메 타객체코드는 QObject 에 추가적 인 기능을 제공한다. 

• C ++ 를파일러를 통한 본래의 실행시형정보 ( RTTI ) 지원을 요구하지 않고 실행시에 
문자렬로서 클라스이름을 돌려주는 classNameO 함수. 

• 객체가 QObject 계승나무안의 지정된 들라스를 계승하는 클라스의 실례인가 아닌 
가를 돌려주는 inherits 0함수 . 

• 국제화에 쓰일 때 문자렬번역용의 tr () 와 trUtf 8() 함수들. 

• 이름에 의하여 객체속성들을 동적으로 설정하고 얻기 위한 setPropertyO 와 
property 0 함수들. 

• 그 콜라스와 련관된 메 타객체를 돌려주는 metaObject 0함수. 
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Q_OBJECT 마크로없이 그리고 메타객체코드없이 기초클라스토서 QObject 를 사용 
할수 있고 한편 Q_OBJECT 마크로를 사용하지 않으면 여기서 서술한 신호와 처리부나 
기타 기능들을 사‘할수 없다. 메타객체체계의 견지로부터 메타코드가 없는 QObject 파 
생콜라스는 메타객체코드를 가지는 그의 가장 가까운 선조와 등가하다. 이것은 실례로 
classNameO 이 자기 클라스의 실제이름을 돌려주지 않지 만 선조의 들라스이 름을 돌려 
준다는것을 의미한다. QObject 의 모든 파생클라스들이 신호, 처리부，속성들을 실제로 
사용하는가 안하는가에 관계 없이 Q_OBJECT 마크로를 사용할것을 강하게 권고한다. 


제 5 절. 속성 

Qt 는 롬파일 러제 작자들에 의 하여 공급되 는것 과 비슷한 복잡한 속성 (property) 체 계 
를 제공한다. 하지만 름파일러 및가동환경에 의존하지 않는 서고처럼 Qt 는 _property 
혹은 [property] 와 같은 비 표준콤파일 러기능에 기초할수 없다. 해결대 책 은 지 원하는 모든 
가동환경 에 대 하여 표준 C++ 름파일 러 와 작업하는것 이 다. 그것 은 신호와 처 리 부를 통한 
객 체 통신도 제 공하는 메 타객 체 체 계 에 기 초하고있 다. 

클라스선언안의 Q_PROPERTY 마크로는 속성을 선언한다. 속성들은 QObject 를 계 
승하는 클라스들에서만 선언될수 있다. 둘째 마크로 Q_OVERRIDE 는 파생들라스에서 계 
승된 속성의 일부를 재정의하는데 쓰일수 있다. 

속성은 외부세계에서 자료성원과 비슷하다. 그러나 속성들은 보통자료성원들과 구 
별되는 여 러가지 기능을 가지고 있다. 

•읽기함수. 이것은 항상 존재한다. 

• 쓰기 함수. 이것은 선택적 이 다. QWidget :: isDesktop 0와 같은 읽기전용속성들은 
쓰기함수를 가지지 않는다. 

• 영속성을 가리키는 《기억된》특성. 대부분의 속성들은 보관되지만 일부 가상속 
성들은 그렇지 않다. 실례 로 QWidget: :minimumWidth() 는 보관되지 않는다. 왜 냐하 
면 그것 이 QWidget: :minimumSize() 의 보기 이 고 자체 의 자료를 가지지 않기 때 문이 다. 

• 상황에 고유한 기정 값으로 속성 을 설정 하는 재설정함수이다. 

• 속성 을 GUI 구축도구(실례 로 Qt Designer) 에 서 유효로 하는것 이 의 의 있는가를 
가리키는《설계가능한》특성. 대부분의 속성들에서 이것은 의미었지만 모두가 그런것 
은 아니다. 실례로 QButton::isDown() 을 들수 있다. 사용자는 단추들을 누를수 있으 
며 프로그람작성자는 프로그람이 자체의 단추를 누르게 할수 있으나 GUI 설계도구는 단 
주를 누를수 없다. 

읽기，쓰기 및 재설정함수들은 속성 이 정의되는 클라스의 공개성 원함수들이 여야 한 
다. 속성들은 사용중에 있는 클라스에 대하여 아무것도 모르고도 QObject 안의 일반함 
수들을 통하여 읽고 씌여질수 있다. 이 두개의 함수호출은 등가하다: 

// QButton *b 과 QObject *0 는 같은 단추를 가리킨다 
b->setDown ( TRUE ); 
o->setProperty( "down", TRUE ); 

하지만 첫번째가 더 빠르고 콤파일시에 훨씬 더 좋은 진단기능을 제공한다. 실천에 
서는 첫번째가 더 좋다. 그러나 QMetaObject 를 통하여 QObject 에 대한 사용가능한 
모든 속성들의 목록을 엄을수 있으므로 QObject::setProperty() 는 콤파일시에 사용할 
수 없는 콜라스들에 대한 조종을 작성자에게 넘긴다. 

QObject: :setProperty() 에는 물론 대 응하는 QObject: : property 0함수가 없다. 
QMetaObject: :propertyNames() 는 사용가능한 모든 속성 들의 이 름을 돌려 준다. 
QMetaObject: : property 0는 이 름있는 속성 용의 속성 자료 즉 QMetaProperty 객 체 를 


102 





돌려 준다. 

여기에 가장 중요한 속성함수들을 보여주는 간단한 실례가 있다. 
class MyClass : public QObject 
{ 

Q—OBJECT 

public ： 

MyClass ( QObject * parent =0, const char * name =0 ); 

-MyClass () : 

enum Priority { High , Low , Very High , VeryLow }; 

void setPriority ( Priority )； 

Priority priority () const ； 

}； 

그 콜라스는 아직 메타객체체계에 알려지지 않은 속성 ” priority ’’ 를 가진다. 알려 
진 속성을 만들려면 그것을 Q_PROPERTY 마크로에 의해 선언해야 한다. 문법은 다음과 
갈다. 

Q _ PROPERTY ( type name READ getFunction [WRITE setFunction ] 
[RESET resetFunctionJ "iDESIGNABLE bool ] 

[SCRIPTABLE booll |STORED bool ] ) 

선언을 유효화하기 위하여 get 함수는 const 이고 형 그자체，그것의 지적자 혹은 그 
에 대한 참고를 돌려주어야 한다. 선택적인 write 함수는 void 를 돌려주고 한개 인수형 
즉 그자체，지적자 혹은 그것에로의 const 참고를 정확히 가져야 한다. 메타객체를파일 
리는 이것을 수행한다. 

속성의 형은 콜라스자체에서 선언된 QVariant 형이나 렬거형일수 있다. MyClass 가 
속성에 대하여 렬거형 Priority 를 사용하므로 이형은 속성체계에 등록되여야 한다. 

여기에 두가지 례외가 있다. 즉 속성의 형은 QValueList < QVariant > 혹은 
QMap < QString , QVariant 〉 일수 있다. 이러한 경우에 형은 QValueList 혹은 
QMap (즉 형판인수없이)토서 지정되여야 한다. 

다음과 같이 이 름에 의 하여 값을 설정할수 있 다. 
obj -> setProperty ( " priority ", " VeryHigh " ); 

QValueList 와 QMap 속성들의 경우에 넘기는 값은 완전한 list 나 map 값을 가지는 
QVariant 이 다. 

렬거형들은 Q_ENUMS 마크로에 의해 등록된다. 여기에 속성과 관련한 선언들을 포 
함하는 최종적 인 콜라스선언이 있다. 

class MyClass : public QObject 

{ 

Q—OBJECT 

Q _ PROPERTY ( Priority priority READ priority WRITE setPriority ) 

Q _ ENUMS ( Priority ) 
public ： 

MyClass ( QObject * parent =0, const char * name =0 ); 

-MyClass () : 

enum Priority { High , Low , Very High , VeryLow }; 

void setPriority ( Priority )； 

Priority priority () const ； 
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다른 비슷한 마크로는 Q_SETS 이 다. Q_SETS 는 Q_ENUMS 처럼 렬거형을 등록하지만 
또한 그것 을 " set " 로서 표식한다. 즉 렬 거 값들은 모두 론리 합할수 있 다. I 八)콜라스는 
렬거값 " Read " 와 " Write " 를 가질수 있으며 ” Read | Write ” 를 받아들일수 있다. 그러한 
enum 은 Q_ENUMS 보다도 Q_SETS 에 의 해 가장 잘 조종된다. 

Q_PROPERTY 부분의 나국지 예약어들은 RESET , DESIGNABLE , SCRIPTABLE 및 
STORED 이 다. 

RESET 는 속성 을 기 정상태 (초기 화후 변경할수 있 다. ) 로 설 정하는 함수의 이 름을 짓 
는다. 그 함수는 void 를 돌려주고 인수를 가지 지 말아야 한다. 

DESIGNABLE 은 속성 이 GUI 설 계 도구에 의 한 수정 에 적 합하다는것 을 선 언 한다. 기 
정값은 써 넣 을수 있 는 속성 들인 경 우에 TRUE 이 고 그렇 지 않으면 FALSE 이 다. TRUE 나 
FALSE 대 신에 boolean 성 원함수를 지 정할수 있 다. 

SCRIPTABLE 은 이 속성 이 스크립 링 엔진에 의 해 접 근하는데 적 합하다는것 을 선언한 
다. 기 정 값은 TRUE 이 다. TRUE 나 FALSE 대 신에 boolean 성 원함수를 지 정할수 있 다. 

STORED 는 객체의 상태를 보관할 때 속성의 값을 보관해야 하는가를 선언한다. 보 
관된것은 써넣기가능속성들에 대하여서만 의미를 가전다. 기정값은 TRUE 이다. 기술적 
으로 불필요한 속성들 (QRect 가 속성이라면 QPoint pos 와 같다.)은 이것을 FALSE 로 
정의 한다. 

추가적인 마크로 ” Q _ CLASSINF ◦"가 속성체계에 련결된다. 이것은 콜라스의 메타 
객체에 추가적인 이름-값 쌍들을 련결하는데 쓰일수 있다. 실례로 

Q _ CLASSINFO ( " Version ", "3.0.0" ) 

다른 메타자료와 같이 들라스정보는 메타객체를 통하여 실행시에 호출할수 있다 
( QMetaObject ： : classInfoO 참고) . 

- Q_OVERRIDE 

QO & ect 파생 콜라스를 계 승할 때 그 들라스의 속성 들의 일부를 무시할수 있 다. 

실례로 QWidget 에서는 다음과 같이 정의된 autoMask 속성을 가전다. 

Q _ PROPERTY ( bool autoMask READ autoMask WRITE setAutoMask 
DESIGNABLE false SCRIPTABLE false ) 

그러 나 자동마스크속성 을 일부 QWidget 파생 클라스들에 서 설 계할수 있게 만들 필요 
가 있다. 마찬가지로 일부 클라스들은 이 속성을 서술(실례로 QSA 용으로)하도록 할 필 
요가 있다. 이것은 파생클라스에서 그 속성의 이러한 특성들을 재정의하여 달성된다. 실 
례로 QCheckBox 에서는 다음의 코드를 사용하여 이것을 달성하다. 

Q _ OVERRIDE ( bool autoMask DESIGNABLE true SCRIPTABLE true ) 

또 하나의 실례는 QToolButton 이다. 기정적으로 QToolButton 은 QBu 竹 on 으로 
부터 계승되므로 읽기전용 " toggleButton " 속성을 가전다. 

Q _ PROPERTY ( bool toggleButton READ isToggleButton ) 

그러나 도구단추를 절환할수 있게 하려고 하므로 QToolButton 에 WRITE 함수를 
써서 다음의 속성을 재정의하는데 사용하여 그것을 호출할수 있게 한다. 

Q _ OVERRIDE ( bool toggleButton WRITE setToggleButton ) 

결과는 도구단추에 대하여 읽고쓰기 boolean 속성의 toggleButton 이 다. 




제 6 절. 어는 왜 신호와 처리부에 형판을 사용하지 않는가? 

간단한 대 답은 Qt 를 설계할 때 여 러가지 름파일러들의 불충분성으로 인하여 여 러가 
동환경에서의 형판기구를 완전히 개발할수 없었기때문이다. 오늘까지도 널리 쓰이는 많 
은 C ++ 름파일러들은 고급한 형판들과 관련한 문제를 가지고있다. 실례로 부분적인 형판 
실 례작성 에 안전하게 의 거할수 없 다. 이 리하여 Qt 에 서 형 판의 사용은상당히 신중해 야 
한다. 이가 여러 가동환경 도구일식이고 Linux / g ++ 가동환경에서의 진보가 결코 다른 
곳의 상황을 개선하지 못한다는것을 명심하여 야 한다. 

우연히 연약한 형판실현을 갖춘 름파일러들이 개선된다. 그러나 모든 사용자들이 
우수한 형판지원을 갖춘 완전히 표준이고 친절한 현대 C ++ 콤과일러를 호출하였다고 하 
여도 메타객체름파일러에 의해 사용된 문자렬에 기초한 수법을 버릴수는 없다. 여기에 
5가지 리유가 있다. 

1. 문법문제 

알고리듬을 표시하는데 쓰이는 문법은 코드의 읽기편리성과 관리능력에 크게 영향 
을 주지 않는다. Qt 의 신호와 처리부에 사용되는 문법은 실천에서 아주 성공적이라는것 
이 증명 되 였 다. 문법 은 직 관적 이 고 사용법 이 단순하고 읽 기 쉽다. Qt 를 배 우는 사람들 
은문법 이 고도로 추상적 이 고 일 반적 인것 임 에도 불구하고 신호와 처 리부개 념을 리해 하고 
사용해야 한다는것을 알고있다. 더우기 클라스정의에서 신호의 선언은신호가 보호 C ++ 
성 원함수라는 의미 에서 보호된다는것 을 담보한다. 이것은 프로그람작성 자들이 거의 처 음 
부터 설계견본에 대하여 생각하지 않고도 정확한 설계를 얻을수 있도록 방조한다. 

2. 사전콤파일러가 좋다 

(교의 moc (메타객체틈파일러)는 콤파일된 언어의 자원으로 넘기는 명백한 방법을 제공 
한다. 임의의 표준 C ++ 틈파일러로 름파일할수 있는 추가적인 C ++ 코드를 생성하여 그렇게 
할수 있다. moc 는 C * 원천파일들을 읽어들인다. Q _ OBJECT 마크로를 포함하는 하나이상의 
콜라스선언을 발견하면 그 콜라스들을 위한 메타객체코드를 포함하는 다른 C ++ 원천파일을 
생성한다. moc 가 생성한 C ++ 원천파일은 콜라스의 실현과 함께 틈파일되고 련결된다. (혹은 
콜라스의 원천파일에 出 nclude 될수 있다.) 일반적으로 moc 는 수동적 으로 호출되지 않고 구 
축체계에 의해 자동적으로 호출되므로 프로그람작성자의 추가적 인 작업을 요구하지 않는다. 

다른 사전름파일러들 실례로 뭐와 抑은 프로그람이나 객체들이 프로쎄스나 를퓨터에서 
통신할수 있게 한다. 사전콤파일러들에서 한가지 문제는 선명치 않은 코드를 생성하는 대화 
칸나 위자드를 갖추고있는 름파일러들，저작권이 있는 언어들 혹은 도형방식프로그람작성도 
구들을 포기하는것 이 다. 저작권이 있는 C ++ 를파일러 나 특정한 통합개발환경에 손님들이 포 
로되게 하는것 이 아니 라 그들이 자기가 좋아하는 어떤 도구든지 사용할수 있게 한다. 

3. 유연성이 제일이다 

C ++ 는 표준화되 고 강력 하고 정 성 들여 만든 일 반목적 언어 이 다. 이것은 쏘프트웨 어 프 
로젝트, 전체 조작체계들에 대해 동작하는 각종 응용프로그람의 전개，자료기지봉사기와 
탁상응용프로그람들에 서 일 반적 인 고말단 도형 방식 응용프로그람과 같은 넓 은 범위 에서 
개발되는 유일한 언어이다. C ++ 성공의 열쇠들중의 하나는 ANSI-C 호환성을 계속 유지 
하면서 최대성능과 최소기 억기소비 에 초점을 둔 확장가능한 ( scalable ) 언어설계 이다. 

이러한 모든 우점들에 대조되는 결함이 있다. C ++ 에서 정적객체모형은 부분품에 기 
초한 도형 방식 사용자대 면부프로그람을 작성 할 때 Objective C 의 동적 통보전송수법 에 
대한 명백한 결함이다. 고말단자료기지봉사기 혹은 조작체계가 결코 GUI 첨단의 옳은 
설계선택은 아니다. moc 를 사용하여 이 결함을 우점으로 전환하고 안전하고 효과적인 
도형방식 사용자대 면부 프로그람작성 에 필 요한 유연성 을 추가하였 다. 
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우리의 수법은 형판에 의해 수행할수 있는 일에 아주 효과있다. 실례로 객체속성들을 
가질수 있다. 그리고 신호와 처리부를 재정의하여 재정의가 주개념으로 되여있는 언어로 
프로그람작성할 때 자연스러운것으로 할수 있다. 신호는 콜라스실례에 Obyte 를 추가한다. 
이것은 2진호환성을 파괴함이 없이 새 신호들을 추가할수 있다는것을 의미한다. 형판에 의 
해 수행한것처럼 과도한 즉시화 ( inlining ) 에 의거하지 않으므로 코드크기를 작게 할수 있 
다. 새로운 련결의 추가는 복잡한 형판함수가 아니라 단순한 함수호출로 전개된다. 

다른 리득은 실행시에 객체의 신호와 처리부들을 탐구할수 있는것이다. 련결하고있 
는 객체들의 정확한 형을 모르고도 형안전하고 이름에 의한 호출을 리용하여 련결을 확 
립할수 있다. 이것은 형판에 기초한 해결로서는 불가능하다. 이리한 종류의 실행시 자기 
관찰 ( introspection ) 은 새로운 가능성을 열어놓는다. 실례로 Qt Designer 의 XML ui 
파일들로부터 생성되고 련결되는 GUI 들. 

4. 성능호출이 모든것은 아니다 

Qt 의 신호와 처리부실현은 형판에 기초한 해결처럼 빠르지 못하다. 신호발생비용은 
거 의 일 반형판실현에 의한 4개 의 보통함수호출의 비 용이 지 만 Qt 는 10개 의 함수호출에 
대하여 상당한 작업을 요구한다. 이것은 Qt 기구가 일반조립기 ( marshaller ), 자기관찰 
과 극도의 스크립트 가능성을 포함하므로 놀랄만한것이 못된다. 이것은 과도한 즉시화와 
코드팽창에 의거하지 않고 실행시안전성을 제공한다. Qt 의 반복자는 안전하지만 고속형 
판에 기초한 체계의 반복자는 그렇지 못하다. 여러개의 수신자들에 신호를 발생하는 처 
리과정에 수신자들은 자기 프로그람을 중단함이 없이 안전하게 삭제될수 있다. 이러한 
안전성이 없이는 자기의 응용프로그람이 해방된 기억기의 읽기 혹은 써넣기오유를 오유 
수정하기 어려운것으로 하여 우연히 중단될것이다. 

그럼에도 불구하고 형판에 기초한 해결이 신호와 처리부를 리용하는 응용프로그람 
의 성능을 개선할수 없는가? Qt 는 신호를 통한 처리부호출비에 적은 비용이 추가되고 
그 호출비 는 처 리 부의 총비 용에서 작은 몫을 차지한다. 일 반적 으로 Qt 의 신호-처 리 부체 
계 에 대 한 성능시험은 빈 처 리부를 가지고 수행된다. 자기의 처 리부에 사용할수 있는 어 
떤 일 실례로 좀 단순한 문자렬조작을 할 때 호출간접비는 무시된다. Qt 체계는 연산자 
new 혹은 delete 를 요구하는 조작(실례로 문자렬조작 혹은 형판용기로부터 무엇인가 
삽입 및 삭제)이 신호발생보다 훨씬 더 많은 비용이 드므로 최적화한다. 

례외: 성능이 림계상태에 이르는 과제의 엄격한 내부순환안에 신호와 처리부가 있 
고 그 련결 이 난관이 라는것 을 확인하였 다면 신호와 처 리 부보다도 표준 청 취 기 ( listener ) 
대면부를 사용한다. 이러한 일이 생기는 경우에 1:1련결만 요구한다. 실례로 망으로부 
터 자료를 내리적재하는 객체가 있다면 요구하는 자료가 도착하였다는것을 가리키는데 
신호를 사용하는것은 완전히 좋은 설계 이다. 그러 나 소비 자에게 매 번 lbyte 씩 보내 야 
한다면 신호와 처리부보다도 표준 청취기대면부를 사용한다. 

5. 제한이 없다 

신호와 처리부용 moc 가 있으므로 형판로 수행할수 없는것에 다른 유용한것들을 추 
가할수 있다. 그중에는 생성된 tr () 함수를 거 치는 유효범위있는 번역과 자기관찰을 갖추 
고있는 고급한 속성체계 및 확장된 실행시형정보가 있다. 속성체계는 큰 우점 을 가지 고 
있다. 즉 강력하고 자기관찰적인 속성체계가 없이 Qt Designer 와 같은 강력하고 일반 
적 인 사용자대면부설계도구를 작성하는것은 훨씬 더 힘들다. 

moc 앞처리기를 갖춘 C ++ 는 본질적으로 우리에게 Objective-C 혹은 Java 실행시환 
경의 유연성을 주는 한편 C ++ 의 독특한 성능과 확장가능성의 우점을 유지한다. 이것이 
오늘 Qt 를 유연하게 하고 편리한 도구로 만들고있다. 
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제 4 장. QtO | 리용방법 


제1절. 설치 

Qt 의 설치절 차는 가동환경 에 따라 다르다. 

1. Qt / Xll 의 설치 

Qt 를 설치하려는 등록부의 사용허가에 따라서 root 로 로그인할 필요가 있다. 

資) 압축파일을 푼다. (이미 풀지 않았으면) 
cd / usr/local 

gunzip qt - xll - version . tar . gz # uncompress the archive 
tar xf qt - xll - version.tar # unpack it 
이것은 기본압축파일의 파일들을 포함할 등록부 / usr / local / qt - T / ersibn 을 창조한다. 
이름을 qt - vers / b /? 으로부터 qt 로 바꾼다. (혹은 기 호련결을 만든다.) 
mv qt-version qt 

나머지 파일은 Qt 가 / usr / local / qt 에 설치된다고 가정한다. 

0 파일 .profile (혹은 자기의 월에 따라서 . login ) 안의 일부 환경변수들을 자기 
의 home 등록부로 설정한다. 그 파일이 거기에 없으면 창조한다. 

QTDIR — (계를 구축하고있는 등록부， 

PATH — moc 프로그람과 다른 Qt 도구들을 배 치 하는 경 로， 

MANPATH — Qt 기본폐지들에 접근하는 경로， 

LD _ LIBRARY_PATH — 공유 Qt 서고의 경로. 

이것은 다음과 같이 수행된다. 

. profile 에 (월이 bash , ksh , zsh 혹은 sh 이면) 다음과 같은 행들을 추가한다. 
QTDIR =/ usr / local/qt 
PATH =$ QTDIR / bin : $PATH 
MANPATH =$ QTDIR / man : SMANPATH 
LD _ LIBRARY _ PATH =$ QTDIR / lib ：$ LD _ LIBRARY_PATH 
export QTDIR PATH MANPATH LD _ LIBRARY_PATH 
. login 에 (월이 csh 나 tcsh 인 경우에) 다음& 같은 행들을 추가한다. 
setenv QTDIR / usr / local/qt 
setenv PATH $ QTDIR / bin：$PATH 
setenv MANPATH $ QTDIR / man : SMANPATH 
setenv LD _ LIBRARY_PATH $ QTDIR / lib ：$ LD _ LIBRARY_PATH 
그다음 다시 로그인하거 & 혹은 계속하기전에 프로파일의 원천을 재구성하여 
$ QTDIR 를 설 정한다. 

LD _ LIBRARY _ PATH 대신에 AIX 에서는 LIBPATH 를， HP - UX 에서는 

SHLIB _ PATH 를 설정한다. 

SGI MIPSpro o 32 와 Sun Workshop 5.0 목표들은 Qt 3. 3에서와 같이 더는 지 
원되지 않는다. 

③ $ HOME /. qt - license 토서 자기 허 가파일 을 설 치한다. 무료판과 평 가판에 서 는 
허가파일이 필요없다. 

④ Qt 서고를 콤파일하고 실례프로그람，련습，도구(실례로 Qt Designer ) 를 다음 
과 같이 입 력하여 구축한다. 
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. /configure 

이것은 자기 름퓨터로부터 Qt 서고환경을 구성한다. GIF 유지는 기정으로 차단된 
다. ./configure - help 를 실행하여 환경선택목록을 얻는다. 지원하고있는 가동환경목 
록용의 PLATFORMS 을 읽는다. 

서 고를 창조하고 모든 실례 와 련습을 를파일하기 위하여 다음과 같이 입 력한다. 
make 

($ 아주 적은 경우에 공유서고를 사용하고있으면 이 시점에서 / sbin / ldconfig 이나 
그와 류사한것을 실행할 필요가 있다. 

실례프로그람들을 실행하는데서 문제가 생기면 실례로다음과 같은 통보가 생기면 
can’t load library ' libqt . so .2' 

환경파일에 qt 서고에로의 참고를 넣고 자기 체계에서 루트로서 / sbin / ldconfig 를 실 
행 할 필요가 있다. 그리 고 우의 ②에서 설명 한것 처 럼 LD _ LIBRARY _ PATH 를 설정 한다. 

⑥ 직결 HTML 문서는 / usr / local / qt / doc / html / 에 설치된다. 기본폐지는 
/ usr / local / qt / doc / html / index . html 이 다. man 페 지 들은 / usr / local / qt / doc / man / 
에 설치된다. 또한 문서는 Qt Assistant 에 의해 호출할수도 있다. 

이제는 Qt 가 설치된다. 

2. Qt / Windows 의 설치 

Qt / Windows 배 포물은 기 본설 치 프로그람을 갖춘 자체 발취 압축파일 로서 배 포된 다. 
그러므로 설치위자드를 실행하면 설치된다. 

3. Qt / Mac 의 설치 

Qt 를 설치하는 등록부의 사용허가에 따라서 root 로 로그인할 필요가 있다. 
t ) 압축파일을 푼다. (이미 하지 않았으면) 
cd /Developer 

gnutar xzf qt - mac - version . tar . gz 

이것은 기본압축파일로부터 파일들을 포함할 등록부 /Developer/qt-version 를 창 
조한다. 

이름을 qt - ve 때 on 으로부터 qt 로 바꾼다. (혹은 기호련결을 만든다.) 
mv qt-version qt 

나머지 파일은 어가 /Developer/qt 에 설 치된다고 가정한다. 

鐘) 파일 .profile (혹은 자기 의 멜 에 따라서 .login) 안의 일부 환경변수를 자기 의 
home 등록부로 설정한다. 파일 이 거기 에 없으면 창조한다. 

QTDIR — (계를 구축하고있는 등록부 
PATH — moc 프로그람과 그밖에 Qt 도구를 찾는 경로 
MANPATH — Qt man 페 지 호출경 로 
LD _ LIBRARY_PATH - 공유 Qt 서고용 경로 
이것은 다음과 같이 수행된다. 

.profile 에서 (자기의 월이 bash , ksh , zsh 혹은 sh 이면) 다음의 행들을 추가한다. 
QTDIR =/ Developer/qt 
PATH =$ QTDIR / bin : $PATH 
MANPATH =$ QTDIR / man : SMANPATH 

DYLD _ LIBRARY _ PATH =$ QTDIR / lib ：$ DYLD _ LIBRARY_PATH 
export QTDIR PATH MANPATH DYLD _ LIBRARY_PATH 
. login 에서 (자기 월이 csh 혹은 tcsh 인 경우에) 다음 행들을 추가한다. 
setenv QTDIR / Developer/qt 
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setenv PATH $ QTDIR / bin：$PATH 

setenv MANPATH $ QTDIR / man : SMANPATH 

setenv DYLD _ LIBRARY_PATH $ QTDIR / lib ：$ DYLD _ LIBRARY_PATH 

그 다음에 다시 로그인하거나 계속하기전에 프로파일원천을 다시 만들수 있다. 

③ 이의 상업판을 가지고있다면 자기의 사용허가파일을 $HOME/.qt-license 토서 설치한다. 

④ Qt 서고를 름파일하고 실례프로그람들과 련습，도구들(실례로 Qt Designer ) 을 
다음과 같이 구축한다. 

입력: 

cd $QTDIR 
. /configure 

이것은 자기 를퓨터용의 Qt 서고환경을 구성한다. GIF 기능은 기정으로 설정되지 않 
는다. ./configure-help 를 실 행 하여 환경 선택 목록을 얻 는다. 

서고를 창조하고 모든 실례와 련습을 콤파일하려면 
make 

⑤ 일단 Qt 를 구축하였다면 사용할 준비가 된다. Qt 가 - static 선택으로 환경구성 
되지 않았다면 Finder 로부터 Qt 응용프로그람들을 호출할수 있게 하기 위하여 탐색등록 
부에 관련서고들을 배치해야 한다. 그 기호련결을 만들것을 권고한다. (-仕 iread 를 가 
지 고 Qt 환경 을 구성하였 다면 아래 의 libqt 를 libqt - mt 로 변경한다. ) 

In -sf $ QTDIR / lib / libqt . 3 .dylib / usr/lib 
In -sf $ QTDIR / lib / libqui . 1. dylib / usr/lib 

이 를 위하여 체 계관리 자호출을 가질 필 요가 있 다. (그 경 우에 매 개 지 령앞에 sudo 
를 놓는다. 실례 로 sudo In -s ...). sudo 를 사용한다면 체 계 관리 자의 암호를 묻는다. 

체 계 관리 자호출을 가지 지 않거 나 혹은 서 고의 사용자설 치 (체 계 설 치 가 아니 라) 를 좋 
아한다면 다음과 같이 할수 있다. (- 仕 iread 를 가지고 Qt 환경을 구성하였다면 아래의 
1比) qt 를 1比) qt - mt 로 변경한다.) 

In -sf $ QTDIR /1 比/ libqt . 3 .dylib $ HOME/lib 
In -sf $ QTDIR / lib / libqui . 1. dylib $ HOME/lib 

이제는 Qt 가 설치된다. Qt 의 문서는 Qt Assistant 혹은 다른 웨브열람기로 읽어들 
일수 있으며 내 용폐지는 $QTDIR/doc/html/index.html 로 된다. 

제2절. Qt 들라그인 

Qt 는 사용자정 의자료기 지 구동프로그람, 화상형 식，본문코드，를포넨트로 이 루어 져 
있는 양식기능들과 도구들을 창조하기 쉽게 하는 간단한 플라그인대면부를 제공한다. 

플라그인작성 은 적 합한 플라그인기초클라스의 파생콜라스를 만들고 일부 함수들을 
실현하고 마크로를 추가함으로써 달성된다. 

표 4-1 에 5개의 플라그인기초클라스가 있다. 파생된 플라그인들은 기정으로 표준플 
라그인등록부에 보관된다. 


표 4-1. _풀라그인기초클라스들 


기초클라스 

기정 경로 

QlmageFormatPlugin 

pluginsbase/imageformats 

QSqlDriverPlugin 

pluginsbase/sqldrivers 

QStylePlugin 

pluginsbase/styles 

QTextCodec P 1 ugin 

pluginsbase/codecs 

Q Widget Plugin 

pluginsbase/designer 
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그러면 pluginsbase 등록부는 어디에 있는가? 응용프로그람을 실행할 때 Qt 는 우 
선 응용프로그람의 실행가능한 등록부를 pluginsbase 로서 취급한다. 실례로 응용프로 
그람이 플라그인형식을 가지고 있다면 C:\Program Files \ MyApp \ styles 를 찾는다. 
(응용프로그람의 실 행 파일 위 치 를 찾는 방법 은 QApplication : : applicationDirPa 仕 1 () 을 
참고하시오.) 또한 어는 qlnstallPathPluginsO 에 의하여 주어지는 등록부를 엄는다. 
아가 추가적 인 위 치를 보게 하려면 QApplication : : addL 比) raryPa 比 i () 호출을 사용하 
여 필요한만큼 경로를 추가해 야 한다. 그리고 자체의 경로를 하나 또는 여 러개 설정 하려 
면 QApplication : : set : UbraryPa 比 is () 를 사용해 야 한다. 

플라그인으로 쓸수있게 만들려는 MyStyle 라는 새 형식콜라스를 가지고있다고 가 
정하자. 필요한 코드는 간단하다. 

class MyStylePlugin : public QStylePlugin 

{ 

public ： 

MyStylePlugin () {} 

- MyStylePlugin () {} 


QStringList keys () const { 
return QStringList () << " mystyle ”; 


QStyle * create ( const QString 技 key ) { 
if ( key == " mystyle " ) 
return new MyStyle ； 
return 0； 


Q _ EXPORT_PLUGIN ( MyStylePlugin ) 

( QStyleFactory 는 대소문자를 구별하고 소문자건을 사용하며 다른 공장 실례로 
QWidgetFactory 는 대소문자를 구별한다.) 

구성 자와 해 체 자는 아무것 도 할 필요가 없 으므로 비 여있 다. 실현해 야 할 가상함수 
는 두개 이다. 첫 번째 는 플라그인에 서 실현된 클라스들의 문자렬 목록을 돌려 주는 keysO 
함수이다. (우의 실례 에서 하나의 콜라스를 실현하였다.) 두번째는 요구되는 콜라스의 
객체(혹은 플라그인이 실현하지 않은 콜라스의 객체를 창조할것을 요구한다면 0) 를 돌 
려 주는 함수이다. QStylePlugin 에 서 두번째 함수는 createO 이 다. 

QStylePlugin . 하나의 플라그인에서 임의의 개수의 플라그인파생들라스를 실현할 
수 있으며 이것은 파생클라스들이 모두 갈은 기초를라스 실례로 QStylePlugin 으로부 
터 파생될수 있게 한다. 

자료기 지 구동프로그람, 화상형 식 , 사용자정의 창문부품, 본문코드에 서 는 어떤 명 시 
적인 객체창조도 요구하지 않는다. Qt 는 필요할 때 그것들을 찾아서 창조한다. 코드에 
서 형식을 명시적으로 설정하려고 하므로 형식 ( style ) 은 례외 이 다. 형식을 적용하기 위 
해서는 다음의 코드를 사용한다. 

QApplication ： ： setStyle ( QStyleFactory ： : create ( " MyStyle " ) ); 

일부 플라그인들라스들은 추가적 인 함수들을 실 현 할것 을요구한다. Qt Designer ^ 
플라그인을 통합하는 특별한 함수들을 실현하는 QWidgetPlugin 의 완전한 실례는 
( Qt 도구의 사용법 》 1장 6절에서 설명한다. QWidge 1 ;Factory 콜라스는 
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QWidgetPlugin 에 추가적 인 정보를 제공한다. 

플라그 인은 표준플라그인보조등독부에 보관되 므로 Qt 응용프로그람들은 자동적 으로 
어 느 플라그인 이 유효한가를 알고있다. 그러 므로 응용프로그람들은 플라그인을 발견하고 
적 재하는 코드를 요구하지 않는다. 즉 Qt 가 자동적 으로 조종한다. 

플라그인의 기정등록부는 QTDIR / plugins ( QTDIR 에 대한 모든 참고는 Qt 가 설 
치된 경로에 귀착된다.)인데 매개 형의 플라그인은 그 형의 보조등록부 실례로 styles 
안에 있 다. 자기 응용프로그람들이 플라그인을 사용하려 고 하는데 표준플라그인경 로를 
사용하지 않으려 면 설 치과정 에 플라그인에 사용하려 는 경 로를 결정하게 하고 실행할 때 
읽어들이는 응용프로그람을 위하여 그 경 로를 보관한다. 그다음 응용프로그람은 이 경로 
를 리 용하여 QApplication : : addLibraryPath () 를 호출하고 자기 의 플라그인들을 응용 
프로그람에 사용할수 있게 된다. 경 로의 마지 막 부분 즉 styles , widgets 등은 변경할 
수 없다. 

응용프로그람에 플라그인을 포함하는 일반적인 방법은 그것을 응용프로그람으로 름 
파일하거 나 DLL (혹은 다른 가동환경 에 고유한 서고형)로 를파일하여 다른 서고처 럼 그 
것 을 사용하는것 이 다. 플라그인을 적재할수 있게 하는 하나의 수법 은 응용프로그람안에 
보조등록부 례를 들면 appdir / plugins / designer 를 창조하고 그 등록부에 플라그인을 
배 치 하는것 이 다. 

Qt Designer 에서는 QApplication : : addLibraiyPa 仕 i (” QTDIR / plugins / designer ") 를 
호출하여 자기의 Qt Designer 플라그인들을 적재 하여 야 한다. 

1. 플라그인의 적재와 확인 

플라그인들을 적재할 때 Qt 서 고는 플라그인을 적재 하여 사용할수 있는가를 결정 하 
는 검사를 한다. 이것은 나란히 설치된 Qt 서고의 여러개의 판본과 환경구성을 가능하게 
한다. 

• 높은 기본판본이나 낮은 보조판본을 가지는 Qt 서고와 련결된 플라그인들은 낮은 
기 본판본이 나 낮은 보조판본을 가지는 서 고에 의하여 적재 되지 않는다. 

리유: Trolltech 는 보조판본의 출하사이에만 새로운 특성과 API 들을 추가하는 정 
책을 실시하고있다. 그것은 이 시험 이 패 취 ( patch ) 준위판번호가 아니라 오직 기본판번 
호와 보조판번 호를 검 사하기 때 문이 다. 

• 스레드를 지원하는 Qt 서고에 련결한 플라그인들은 스레드를 지원하여 구축되는 
서고에 의해서만 적재될수 있다. 

리유: 스레드 및 비스레드화된 Qt 서고들은 다른 이름을 가진다. 비스레드 Qt 서고 
에 련결된 플라그인을 적재하는 스레 드지 원서 고는 두 판본의 같은 서 고가 동시 에 기 억 기 
에 있게 한다. UNIX 체계에서 이것은 비스레드화된 Qt 서고를 적재하게 한다. 이러한 
일 이 발생하면 Qt 서 고에서 모든 정적객체들의 구성 자들은 두번째 로 호출되지 만 그것들 
은 벌써 기 억 기의 객 체들에 대 하여 조작한다. 이것과 작업하는 방법은 없다. 이것은 스 
레드화된 Qt 서고에 의하여 이미 정의된 정적기호들을 비스레드화된 Qt 서고가 적재될 때 
교체 하거 나 복사할수 없는 목적 2진형 식 의 특성 이 다. 

• 비스레드 Qt 서고에 련결된 플라그인들은 스레드를 지원하지 않고 구축되는 서고 
에 의하여 적재될수 있을뿐이 다. 

리유: 우의 리유를 보시오. 

• Qt 3.0.5 로 시작할 때 Qt 서고와 플라그인들은 구축건 (build key ) 에 기초하여 
구축된다. Qt 서고의 구축건을 플라그인의 구축건과 대조하여 그것들이 일치하면 플라그 
인이 적재되고 일치하지 않으면 플라그인의 적재는 거부된다. 

리유: 아래의 구축건의 리유를 보시오 
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2. 구축건 

구축건은 다음과 갈은 정보를 포함한다. 

• 구성 방식과 조작체계 , 콤파일러 

리유: 서로 다른 판본의 갈은 름파일러가 2진호환코드를 생성하지 못하는 경우에 
콤파일러의 판본은 구축건에 주어진다. 

• Qt 서고의 환경구성. 환경구성은 서고안의 유효 API 에 영향을 주는 보이지 않는 
특성들의 목록이다. 

리유: 같은 판본의 Qt 서고의서로 다른 2개 환경구성은 2진호환되지 않는다. 플라 
그인을 적재하는 Qt 서고는 (보이지 않는)특성들의 목록을 사용하여 그 플라그인이 2진 
호환되 는가를 결 정한다. 

알아두기 •. 두가지 다른 구성방식에서 플라그인이 유효특성들을 사용할수 있는 경우 
가 있다. 하지만 플라그인을 쓰는 개발자는 플라그인과 Qt 에서 편의클라스들에서 내적 
으로 어 떤 특성 들을 사용하고있는가 알아야 한다. Qt 서 고는 플라그인을 적재할 때 복잡 
한 기 능과 의 존관계질 문，검 증을 요구한다. 이 요구는 개 발자에 게 불필 요한 부담을 주고 
플라그인적재 의 비 용을 늘인다. 개 발시 간과 응용프로그람실 행 원가를 모두 줄이 기 위하여 
구축건들의 간단한 문자렬대조가 사용된다. 

• 선택적으로 여분의 문자렬을 configure 스크립트지령행에 지정할수 있다. 

리유: 응용프로그람과 함께 Qt 서 고의 2진파일들을 배포할 때 이것은 개 발자들에 게 
플라그인들이 련결된 서고에 의하여서만 적재 될수 있는 플라그인작성방법을 제공한다. 

3. 플라그인과 스레드응용프로그람 

스레드화된 Qt 서고(플라그인자체가 스레드를 사용하는가 안하는가에 따라)와 함께 
사용하려는 플라그인을 구축하려고 한다면 스레드환경을 사용해야 한다. 특히 스레드 Qt 
서고와 플라그인을 련결해야 하며 그 서고와 함께 Qt Designer 를 구축해야 한다. 자기 
플라그인의 . pro 파일은 다음 행 에 포함하여 야 한다. 

CONFIG += thread 

경고: 응용프로그람에서 보통의 Qt 서고와 스레드화된 Qt 서고를 혼합하지 말아야 
한다. 자기 응용프로그람이 스레드화된 Qt 서고를 사용한다면 자기 플라그인을 보통의 Qt 
서 고와 련결하지 말아야 한다. 보통의 Qt 서 고를 동적 으로 적재하거 나 다른 서 고 실례 로 
보통의 Qt 서고에 의존하는 플라그인을 동적으로 적재하여서는 안된다. 일부 체계에서 
스레드화 및 비스레드화된 서고들이나 플라그인들의 혼합은 Qt 서고에서 사용하는 정적 
자료를 못쓰게 한다. 


제3절. QDataStream 연산자들의 형식 

QDataStream 는 일부 Qt 자료형들을 계렬화한다. 표 4-2 는 QDataStream 이 계렬 
화하고 표시할수 있는 자료형을 렬거한다. 

옹근수들을 써넣을 때 Qt 옹근수로 강제변환하고 읽을 때에는 같은 Qt 옹근수형으로 
읽어들여 야 한다. 

표 4-2. __ Qt 자료형 _ 


QJNT 8 

부호있는 바이트 

Q — INT 16 

부호있는 16 bit 옹근수 

QJNT 32 

부호 있 는 32 bit 옹근수 

Q . UINT 8 

부호없는 바이트 

Q _ UINT 16 

부호없는 16 bit 옹 2■수 
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Q _ UINT 32 

부호없는 32 bit 옹근수 

float 

32 bit 류동소수점수. 표준 IEEE -754 형식을 사용한다. 

double 

64 bit 류동소수점수. 표준 IEEE -754 형식을 사용한다. 

char * 

0완료를 포함하는 문자렬의 크기 ( Q _ UINT 32) 

0완료를 포함하는 문자렬바이트 

null 문자렬은 ( Q _ UINT 32)0 으로 표시된다. 

QBitArray 

배 렬 크기 ( Q _ UINT 32) 

배렬비트 즉 ( size +7)/8 byte 

QBrush 

솔형 식 ( Q _ UINT 8) 

솔의 색 ( QColor ) 

형식이 CustomPattern 이면 솔픽스매프 ( QPixmap ) 

QByteArray 

배 렬 크기 ( Q _ UINT 32) 

배렬바이트 즉 크기바이트 

QCString 

0완료를 포함하는 문자렬의 크기 ( Q _ UINT 32) 

0완료를 포함하는 문자렬바이트 

null 문자렬은 ( Q _ UINT 32)0 으로 표시된다. 

QColor 

Q _ UINT 32 로서 계렬화된 RGB 값 

QColorGroup 

foreground ( QBrush ) 
button ( QBrush ) 
light ( QBrush ) 
midLight ( QBrush ) 
dark ( QBrush ) 
mid ( QBrush ) 
text ( QBrush ) 
brightText ( QBrush ) 

ButtonText ( QBrush ) 
base ( QBrush ) 
background ( QBrush ) 
shadow ( QBrush ) 
highlight ( QBrush ) 
high 1 ightedText ( QBrush ) 

QCursor 

형태식별자 ( Q _ INT 16) 

형래가 BitmapCursor 이면 즉 비트매프 ( QPixmap ) 와 마스크 
( QPixmap ) , hot spot ( QPoint ) 

QDate 

율리우스날자 ( Q _ UINT 32) 

QDateTime 

날자 ( QDate ) 

시간 ( QTitne ) 

QFont 

가계 ( QCString ) 

점크기 ( Q _ INT 16) 

형 식암시 ( QJJINT 8) 

문자모임 ( Q _ UINT 8) 

무게 ( Q _ UINT 8) 


서 체 비 트 (Q UINT 8) 








제 4 절. 오유수정 

여 기서는 Qt 에 기초하는 쏘프트웨어 를 오유수정 하기 위한 몇 가지 쓸모있는 암시를 
제시 한다. 

1. 지 령행 추가선택 

Qt 프로그람을 실행할 때 오유수정을 방조할수 있는 몇 가지 지 령행추가선택을 표 4- 
3에 주었다. 


표 4-3. _오유수정 지 령행 추가선택 


추가선택 

결과 

-nograb 

응용프로그람은 마우스 혹은 건반을 포획하지 말아야 한다. 이 
추가선택은 Linux 에서 프로그람을 오유수정기 gdb 에서 실행하고 
있을 때 기정으로 설정된다. 

- dograb 

암시적이거나 명시적인 - nograb 를 무시한다. -nograb 가 지령행 
의 마지 막인 경우에도 -dograb 가 -nograb 보다 우선권이 높다. 

-sync 

X 동기방식에서 응용프로그람을 실행한다. 동기방식은 X 봉사기가 
매 개 X 의 뢰 기 요구를 즉시 처 리하게 하며 완충기 최 적 화를 사용하 
지 않는다. 이것은 프로그람의 오유수정을 쉽게 하지만 아주 느 
리게 한다. -sync 선택은 Qt 의 XII 판에서만 유효하다. 


2. 경고와 오유수정통보 

Qt 는 경고 및 오유수정본문을 쓰기 위한 3개의 대 역함수를 포함한다. 

• qDebugO 는 시 험 등을 위한 오유수정 출력 을 쓴다. 

• qWarningO 은 프로그람오유가 발생 할 때 경 고출력 을 쓴다. 

• qFatalO 은 치명적오유통보를 쓰고 완료한다. 

어에서 이 함수들의 실현은 Unix / Xll 에서는 stderr 출력에， Windows 에서는 오유 
수정기에 본문을 출력한다. 통보문처리함수 qlnstallMsgHandlerO 를 설치하여 이 함 
수들을 물려 받을수 있다. 

오유수정 함수 QObject : : dumpObjectTree () 와 QObject :: dumpObjectlnfoO 는 
흔히 응용프로그람이 이상하게 보이거 나 동작할 때 쓸모있다. 객체이름을 사용할 때 더 
쓸모있지만 지어는 이름없이도 사용할수 있다. 

3. 오유수정마크로 

머 리부파일 Qglobal . h 는 많은 오유수정정보와 # define 들을 포함한다. 

2개의 중요한 마크로가 있다. 즉 

• Q _ ASSERT ( b ), 여기서 b 는 론리식이고 논가 FALSE 이면 경고 ’’ ASSERT : 
’ b ’ in file file.cpp (234)’’ 를 출력 한다. 

• Q _ CHECK _ PTR ( p ), 여기서 p 는 지적자이다. p 가 0이면 경고 "In file 
file . cpp , line 234： Out of memory " 를 출력한다. 

이 마크로들은 프로그람오유를 탐지하는데 쓸수 있다. 례를 들면 
char * alloc ( int size ) 

{ 

Q _ ASSERT ( size > 0 )； 
char *p = new char [ size ]; 

Q _ CHECK _ PTR ( p )； 
return p ； 
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기 발 QT _ FATAL _ ASSERT 를 정 의하면 Q _ ASSERT 는 warningO 대 신에 
fatalO 을 호출하므로 실규한 확인문 ( assertion ) 은 오유통보를 출력한 후에 프로그람을 
완료시킨다. QT _ CHECK_STATE 가 정의되지 않으면 Q — ASSERT 마크로는 null 식이다. 
그안의 코드는 호순히 실행되지 않는다. 마찬가지로 QT _ CHECK_NULL 가 정의되지 않으 
면 Q _ CHECK _ PTR 는 null 식이다. 여기에 Q — ASSERT 와 Q _ ᄅ HECK — PTR 를 사용하 
지 말아야 하는 실례가 있다. 

char * alloc ( int size ) 

{ 

char * p ； 

Q _ CHECK _ PTR ( p = new char [size j ■: // WRONG ! 

return p ； 

} 

，는 정확한 검사값이 정의되기만 하면 그 값으로 설정된다. 이 코드가 정의된 
QT _ CHECK _ NULL 기 발없이 콤파일되면 Q _ CHECK _ PTR 식 안의 코드는 실행되지 않 
고(정확히 오유수정목적뿐이므로) alloc 는 임 j 의 지적자를 돌려준다. 

Qt 서 고는 오유가 발견될 때 경 고통보를 출력하는 수백 개 의 내 부검 사를 포함한다. 

Qt 내에서 제대로 되는가하는 시험과 결과에 따라 생기는 경고통보는 여러가지 오유 
수정기 발의 상태 에 기초한다(표 4-4). 


표 4-4. 

오유수정 기 발 

기발 

의미 

QT _ CHECK_STATE 

비모순성과 기대한 객체상태검사 

QT _ CHECK_RANGE 

변수범위오유검사 

QT _ CHECK_NULL 

위험한 null 지적자검사 

QT _ CHECK_MATH 

위험 한 수학오유，실 례 로 0에 의 한 나누기 를 검 사 

QT _ NO_CHECK 

모든 QT _ CHECK _... 기 발들을 해 제 

QT_DEBUG 

오유수정코드허용 

QT _ NO_DEBUG 

QT _ DEBUG 기발 해제 


기정 으로 QT_DEBUG 와 모든 QT_CHECK 기 발들은 설정 되 여있다 . QT_DEBUG 
를 해 제 하려 면 QT_NO_DEBUG 를 정 의 한다 . QT_CHECK 기 발들을 해 제 하려 면 
QT_NO_CHECK 를 j 의 ‘ 다 . 

실례 : 

void f ( char * p , int i ) 

#if defined ( QT _ CHECK _ NULL ) 
if ( p == 0 ) 

qWarningC "f ： Null pointer not allowed " ); 

#endif 

#if defined ( QT _ CHECK _ RANGE ) 
if ( i < 0 ) 

qWarningC " f ： The index cannot be negative " ); 

#endif 
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4. 일반오유 

여기서 마땅히 언급해야 할 일반오유가 하나 있다. 즉 콜라스선언에 Q_OBJECT 
마크로를 선언하고 moc 를 실행하지만 실행파일에 moc 가 생성한 목적코드를 련결하지 
않으면 오유통보를 얻는다. vtbl, _vtbl, _vtbl 의 결핍이나 그와 류사한 련결오유는 이러 
한 문제의 결과이 다. 


제5절. 끝어다놓기 

끌어다놓기는 사용자가 응용프로그람들사이 혹은 그 안에서 정보를 전송하는데 사 
용할수 있는 간단한 시각적기구를 제공한다. 끌어다놓기는 오려둠판의 자르기-붙이기기 
구의 기 능과 비 슷하다. (끌어 다놓기실 례 들에 대 하여 서 는 qt/examples/iconview/simp 1 e_dd , 
qt/examples/dragdrop, qt/examples/fileiconview, 또한 QTextEdit 창문부품원천코드를 참고하 
시오.) 

1. 끌기 

실례로 마우스이동사건에서 끌기를 시작하려면 본문일 때 QTextDrag , 화상일 때 
QlmageDrag 와 같이 자기 매체에 적당한 QDragObject 파생클라스의 객체를 창조한다. 
그다음 dragO 메쏘드를 호출한다. 

실례로 창문부품으로부터 본문의 끌기를 시작하려면 다음과 같이 한다. 

void My Widget ： : startDragO 

| 

QDragObject *d = new QTextDrag ( myHighlightedText (), this ) ； 
d -> dragCopy (); 

// do NOT delete d. 

} 

QDragObject 는 끌기 후에 삭제 되 지 않는다. QDragObject 는 아직 다른 프로쎄 스와 교제 하 
고있을수 있으므로 끌기 가 명 백 히 끝난 후에 도 존재 할 필요가 있다. 우연적 으로 Qt 는 그 객 체 
를 삭제 한다. 끌기 객 체 를 소유하는 창문부품이 그전 에 삭제 되 면 종속된 놓기 가 취 소되 고 끌기 
객 체 는 삭제 된 다. 이 러 한 리 유로 객 체 가 무엇 을 참고하는가 하는데 주의 해 야 한다. 

2. 놓기 

창문부품에 놓은 매체를 받아들일수 있게 하려면 그 창문부품에 대하여 구성자에서 
setAcceptDrops ( TRUE ) 을 호출하고 사건 처 리 함수메 쏘드들 인 dragEnterEventO 와 
dropEventO 를 재정의한다. 더 복잡한 응용프로그람들에서도 dragMoveEventO 와 
dragLeaveEventO 의 재정의가 필요하다. 

실례로 본문과 화상 놓기를 받아들이기 위하여 

My Widget :: My Widget (...) : Q Widget (...) 


setAcceptDrops (TRUE) ； 


void My Widget :: dragEnterEvent (QDragEnterEvent* event) 

{ 

event->accept( QTextDrag： : canDecode(event) || 

QlmageDrag ： : canDecode(event) ) ； 
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void My Widget： : dropEvent(QDropEvent* event) 

{ 

Qlmage image ； 

QString text ； 

if ( QlmageDrag： : decode (event, image) ) { 
insertlmageAt (image, event -〉 pos 0) ； 

} else if ( QTextDrag： : decode (event, text) ) { 
insertTextAt (text, event -〉 pos 0); 

} 

} 

3. 오려둠판 

QDragObject 와 QDragEnterEvent, QDragMoveEvent, QDropEvent 클라스 
들은 모두 형 정 보를 제 공하는 객 체 들의 클라스 QMimeSource 의 파생 클라스들이다. 
QDragObject 에 기초하여 자료를 전송한다면 끌어 다놓기를 엄을뿐아니 라 무료로 자르기 
및 붙이기도 엄을수 있다. QClipboard 는 두개 함수를 가전다. 
setData (QMimeSou rce*) 

QMimeSource* data() const 

이 함수들을 리용하여 보통 오려둠판에 끌어 다놓기정보를 넣을수 있다. 
void My Widget： : copy () 

{ 

QApplication :: clipboard 0 -> setData ( 
new QTextDrag (myHigh lightedText ()) ) ； 


void My Widget： : paste () 

{ 

QString text ； 

if ( QTextDrag： : decode (QApplication： : clipboard ()->data(), text) ) 
insertText( text ) ； 

} 

지어 QDragObject 파생클라스들을 파일입출력의 부분으로 사용할수 있다. 실례로 
자기 응용프로 그람이 CAD 설계를 DXF 형식으로 부호화하는 QDragObject 의 파생클라 
스를 가지 고있으면 보관과 적재 코드는 다음과 같다. 
void My Widget： : saveO 
{ 

QFile out(current_file_name) ； 
if ( out. open (IO_WriteOnly) ) { 

MyCadDrag tmp(current_design) ； 

out. writeBlock( tmp->encodedData( M image/x-dxf M ) ) ； 

} 
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void My Widget ： : loadO 

{ 

QFile in ( current _ file _ name ) : 

if ( in . open ( IO _ ReadOnly ) ) { 
if ( ! MyCadDrag :: decode ( in . readAl 1(), current _ design ) ) { 
QMessageBox ： : warning ( this , "Format error ", 
trC'The file \"%1\" is not in any supported 

format "). arg ( current _ file _ name ) 

)； 

} 

} 

} 

QDragObject 파생 콜라스는 MyDxfDrag 가 아니라 MyCadDrag 이다. 왜냐하면 앞 
으로 그것을 확장하여 다른 응용프로그람들에 DXF , DWG , SVF , WMF , 혹은 

QPicture 자료를 제공할수 있기때문이다. 

4. 끌어다놓기작용 

더 간단한 경우에 끌어다놓기의 목표는 끌고있는 자료의 사본을 받아들이고 원본을 
삭제 하겠는가를 결정 한다. 이것은 QDropEvent 에서의 Copy 작용이 다. 또한 목표는 다 
른 작용 특히 Move 와 Link 작용을 리 해 하도록 선택할수 있 다. 목표는 Move 작용을 리 
해하고 복사와 삭제조작들에 둘다 응답할수 있으며 원천은 자료자체를 삭제하려고 시도 
하지 않는다. 목표가 Link 를 리해하면 그것은 원시정보에 대한 그자체의 참고를 보관하 
고 다시 원천은 원본을 삭제하지 않는다. 끌어다놓기작용의 가장 일반적인 사용은 같은 
창문부품안에 서 Move 를 수행할 때 이 다. 

끌기작용의 다른 주요한 사용은 본문 및 uri 목록과 같은 참고형을 리용하는 경우이 
다. 여기서 끌기하는 자료는 실제로 파일들이나 객체들에로의 참고이다. 

5. 새로운 끌어 다놓기형의 추가 

우의 DXF 실례에서 제안한것처럼 끌어다놓기는 본문과 화상에만 제한되지 않는다. 
임의의 정 보를 끌어 다놓을수 있다. 응용프로그람들사이 에서 정 보를 끌기하려 면 응용프로 
그람들은 받아들이 고 생 성할수 있는 자료형 식 들을 서 로 알릴수 있게 하여 야 한다. 이 것 
은 MIME 형 들에 의 해 달성된다. 즉 끌기 원천은 생 성할수 있는 MIME 형 들의 목록(제 일 
적합한것으로부터 적합하지 않은 순서로)을 제공하고 놓기목표는 받아들일수 있는것이 
어 느것 인가 선택 한다. 실례 로 QTextDrag 는 text / plain 의 MIME 형 (보통 비형식 화된 
본문)과 유니코드형식들인 text 八 1 仕 16 와 text 八 I 社8에 대한 지원을 제공한다. 
QlmageDrag 는 image /* 에 제공되는데 여기서 * 는 QlmagelO 가 지원하는 화상형식이 
다. QUriDrag 파생콜라스는 파일이름 (혹은 URL ) 들의 목록을 전송하기 위한 표준형식 
인 text / uri - list 를 제공한다. 

QDragObject 파생콜라스를 사용할수 없는 형의 정보에 대한 끌어다놓기를 실현하 
는데서 가장 중요한 첫단계는 적합한 현존형식을 찾는것이다. I ANA (Internet 
Assigned Numbers Authority ) 는 ISI (Information Sciences Institute ) 에서 
MIME 매체형들의 계층목록을 제공한다. 표준 MIME 형들의 사용은 현재와 앞으로 자기 
응용프로그람과 다른 쏘프트웨어 와의 호상운영 성 을 최 대 화한다. 

추가적인 매체형을 지원하려면 QDragObject 혹은 QStoredDrag 의 파생콜라스를 
만든다. 여러매체형에 대한 지원을 제공할 필요가 있을 때 QDragObject 의 파생들라스 
를 만든다. 어떤 형이 충분할 때 더 간단한 QStoredDrag 의 파생콜라스를 만든다. 
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QDragObject 의 파생클라스들은 const char * format (int i ) const 와 
QByteArray encodedData(const char * mimetype ) const 성원들을 재정의하며 매체 
자료를 부호화하기 위한 set 메쏘드, 들어오는 자료를 복호화하기 위한 정적함수들인 
canDecode 0 와 decode 0, QlmageDrag 의 bool canDecode ( QMimeSource *) 
const 와 QByteArray decode ( QMimeSource *) const 를 제 공한다. 물론 이 메 쏘드들 
중 일부를 생략하여 어떤 매체형에 대하여 끌기만 혹은 놓기만 제공할수 있다. 

QStoredDrag 의 파생클라스들은 매체자료를 부호화하기 위한 set 메쏘드와 들어오 
는 자료를 복호화하기 위한 같은 정적성원들인 canDecodeO 와 decode ()1- 제공한다. 

6. 고급한 끌어 다놓기 

오려둠판모형에서 사용자는 원천정보를 자르거나 복사하고 후에 그것을 붙이기할수 
있다. 마찬가지 로 끌어 다놓기모형 에서 사용자는 정보의 사본을 끌기 할수 있으며 혹은 정 
보자체를(이동하여) 새 위치에 끌기할수 있다. 그러나 끌어다놓기모형은 프로그람작성자 
에 게 추가적 인 복잡성 을 제 기 한다. 프로그람은 놓기(붙이 기 )가 수행 될 때 까지 사용자가 
자르려 는지 복사하려 는지 모른다. 응용프로그람들사이 의 끌기 에 는 차이 가 없지 만 응용프 
로그람안에서 끌기하는 경우에는 주의해야 한다. 실례로 문서에서 주위의 본문을 끌기 
위하여 끌기시작점과 놓기사건은 다음과 같이 만들수 있다. 

void MyEditor ： : startDragO 

{ 

QDragObject *d = new QTextDrag ( myHighlightedText (), this ) ； 
if ( d -> drag () 技技 d -> target () != this ) 
cutMyHighlightedText () ； 

} 


void MyEditor : : dropEvent ( QDropEvent * event ) 

{ 

QString text ； 

if ( QTextDrag ： : decode ( event , text ) ) { 
if ( event -> source () == this 技技 event -> action () 

QDropEvent :: Move ) { 

// Careful not to tread on my own feet 
event -〉 acceptAction () ； 
moveMyHighlightedTextTo ( event->pos 0); 

} else { 

pasteT ext At ( text , event-〉pos 0); 

} 


일부 창문부품들은 자료를 그 우로 끌기할 때 yes 혹은 no 응답보다 더 고유하다. 
실례로 CAD 프로그람은 오직 보기에서 본문객체들에로 본문의 놓기를 받아들일수 있다. 
이 경우에 dragMoveEventO 가 사용되고 끌기를 받아들이 거나 무시 하는 구역이 주어 
전다. 

void My Widget :: dragMoveE vent (QDragMoveE vent * event ) 

{ 

if ( QTextDrag :: canDecode ( event ) ) { 
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MyCadltem * item = findMyItemAt ( event -> pos ()) ； 
if ( item ) 
event->accept 0 : 

} 

} 

객체들을 찾는 계산이 아주 느리고 접수를 허용하는 구역을 체계에 알려주어 개선 
된 성능을 엄을수 있다. 

void My Widget :: dragMoveEvent ( QDragMoveEvent * event ) 

{ 

if ( QTextDrag : :canDecode ( event ) ) { 

MyCadltem * item = findMyItemAt ( event -> pos ()) : 
if ( item ) { 

QRect r = item_>areaRelativeToMeClippedByAnythingInTheWay 0; 
if ( item -> type () MyTextType ) 
event -> accept ( r ); 
else 

event -> ignore ( r ); 

} 


또한 dragMoveEvent 0 는 시계를 기동하기 위하여，창문을 흘림하기 위하여，혹 
은 무엇인가 적당한 일을 하기 위하여 끌기진척과정으로서 시각적 인 반결합을 줄 필요가 
있는 경우에 사용될수 있다. (그러나 dragLeaveEventO 에서 흘림과 시계를 중지하여 
야 한다.) 

또한 QApplication 객 체 ( qApp 대 역 변수로서 사용할수 있 다. )는 다음 함수들과 관 
련한 끌어 다놓기 를 제 공한다. 즉 QApplication :: setStartDragTime () , 
QApplication :: setStartDragDistance (), 그리 고 그에 대 응하는 얻 기 함수들， 
QApplication :: startDragTime 0 ， QApplication :: startDragDistance 0 . 

7. 다른 응용프로그람들과의 호상운영 

XII 에서는 공개 XDND 통신규약을 사용하고 Windows 에서 어는 OLE 표준을 사용 
하며 Qt/Mac 는 Carbon Drag Manager 를 사용한다. XII 에서는 XDND 가 MIME 를 
사용하므로 번역이 필요없다. Qt API 는 가동환경에 관계없이 같다. Windows 에서 
MIME - 를 인식 하는 응용프로그람들은 MIME 형 의 오려 둠판형 식이 름을 리 용하여 교제할 
수 있다. 이미 일부 Windows 응용프로그람들은 오려둠판형식들에 MIME 명명관례를 사 
용한다. 내적으로 Qt 는 MIME 형들에 대하여 소유권이 있는 오려둠판형식들을 변환하기 
위한 편의 도구들을 가지 고있다. 이 대 면부는 어떤 경우에는 공개 로 만들어지지만 지금 
그러한 변환을 해 야 한다면 Qt 의 기 술봉사를 받아야 한다. 

또한 XII 에서 어는 Motif Drag&Drop Protocol 를 거처서 놓기를 유지한다. 그 
실현은 원래 Daniel Dardailler 에 의해 작성되였고 Matt Koss 와 Trolltech 에 의해 
Qt 에 받아들인 코드와 결합되였다. 
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제 6 절. 사건과 사건려과기 

Qt 에서 사건은 QEvent 를 계승하는 객체 이 다. 사건들은 QObject : : event 0호출을 
통하여 QObject 를 계승하는 객체들에 배달된다. 사건배달은 사건이 발생하였고 
QEvent 가 정확히 무엇인가 가리키며 QObject 가 응답할 필요가 있다는것을 의미한다. 
대부분의 사건들은 QWidget 와 그 파생클라스들에 고유하지만 도형처리와 관련하지 않 
은 중요한 사건들 (실례로 QSocketNotifier 에 의 하여 사용되는 사건인 소케 트기 능) 이 
있 다. 

일부 사건들은 창문체 계 로부터 일 어나며 (실 례 로 QMouseEvent ) 일부 사건들은 다 
른 원천(실례로 QTimerEvent ) 으로부터 일어나며 일부는 응용프로그람으로부터 일어난 
다. 보통 Qt 는 균형 이 이 루어 져 있으므로 Qt 자체 의 사건순환고리 가 수행하는것 과 같은 
방법으로 정확히 사건들을 보낼수 있다. 

대부분의 사건형은 특수한 콜라스들이다. 가장 일반적인것들은 QResizeEvent 와 
QPaintEvent , QMouseEvent , QKeyEvent , QCloseEvent 이다. 다른것들도 많은 
데 약 40여개 된다. 

매개 골라스는 QEvent 의 파생콜라스이고 사건에 고유한 기능들을 추가한다. 실례 
로 QResizeEvent . QResizeEvent 의 경 우에 QResizeEvent : : size () 와 
QResizeEvent ： : oldSize () 가 추가된 다. 

일부 들라스들은 하나이상의 사건형을 유지한다. QMouseEvent 는 마우스이동과 
누르기 , Shift 누르기，끌기，찰칵，오른단추누르기 등을 유지한다. 

프로그람들이 여러가지 방식으로 반응해야 하므로 Qt 의 사건배달기구는 유연해야 
한다. QApplication :: notify () 는 응용프로그람에 대하여 간단히 설명한다. 

사건을 배달하는 표준방법은 가상함수를 호출하는것이다. 실례로 QPaintEvent 는 
QWidget : : paintEvent 0호출에 의 하여 배 달된다. 이 가상함수는 적 당히 반응하여 보통 
창문부품을 다시 그리기하여 응답할수 있다. 가상함수의 실현에서 필요한 작업을 모두 
수행하지 않으면 기초클라스의 실현을 호출할 필요가 있다. 실례로 

MyTable ： ： contentsMouseMoveEvent ( QMouseEvent *me ) 

{ 

// my implementation 

QTable ： : contentsMouseMoveE vent ( me ); // 그것을 넘겨준다 

} 

기초콜라스의 함수를 교체하려면 자체로 모든것을 실현해야 하지만 기초클라스의 
기 능을 확장하려 고만 한다면 요구되 는것 을 실현하고 기 초콜라스를 호출한다. 

때때로 그러한 사건에 고유한 함수가 없거나 사건에 고유한 함수가 충분하지 않다. 
가장 일반적 인 실례는 건누르기 이다. 보통 건누르기는 QWidget 에 의해 해석되 여 건반 
초점을 이동시키지만 일부 창문부품들은 타브건을 요구한다. 

이 객체들은 일반사건처 리 함수인 QObject : : event 0을 재정의 할수 있으며 일반적 
인 처리의 전후에 사건처리를 수행하거나 사건처리를 완전히 교체한다. 타브를 해석하며 
응용프로그람에 고유한 사용자정 의 사건을 가지 는 매 우 비일 반적 인 창문부품을 포함할수 
있 다. 

bool MyClass：event ( QEvent *evt ) { 
if ( evt -> type 0 == QEvent： : KeyPress ) { 

QKeyEvent *ke = (QKeyEvent *) evt ; 
if ( ke -> key () == Key_Tab ) { 

// special tab handling here 
ke -> accept0 : 
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return TRUE ； 

} 

} else if ( evt -> type () >= QEvent::User ) { 

QCustomEvent *ce = ( QCustomEvent *) evt ； 

// custom event handling here 
return TRUE ； 

} 

return QWidget::event ( evt ); 

} 

일반적으로 객체는 다른 객체들의 사건을 고찰할 필요가 있다. Qt 는 
QObject : : installEventFilter () 에 의하여 이것을 지 원한다. (그리고 대응하는것은 삭제 
한다.) 실례로 보통 대화칸은 일부 창문부품들에서 건누르기를 려과하려고 한다. 실례로 
Return 건처 리를 수정 하려고 한다. 

사건려과기는 목표객체가 수행하기전에 사건들을 처리하게 한다. 려과기의 
QObject : : eventFilter () 실현이 호출되고 려과기를 받아들이거 나 거부하고 사건의 앞으 
로의 처리를 허용하거나 거부한다. 모든 사건려과기들이 앞으로의 사건처리를 허용하면 
사건은 목표객체자체에 보내진다. 그중 하나가 처리를 중지하면 목표와 그후의 사건려과 
기들은 사건을 전혀 보지 못하게 한다. 

또한 QApplication 에 사건려과기를 설치함으로써 전체 응용프로그람을 위한 사건 
들을 모두 려과할수도 있다. 이것은 마우스와 건반동작을 모두 조사하기 위하여 
QToolTip 가 수행하는것이다. 이것은 아주 강력하지만 전체 응용프로그람에서 모든 단 
일사건의 사건송달이 떠지게 하므로 피하는것 이 제 일 좋다. 

대역사건려과기들은 객체에 고유한 려과기들보다 먼저 호출된다. 

끝으로 많은 응용프로그람들은 자체의 사건들을 창조하고 송신하려고 한다. 

기본형의 사건창조는 아주 단순하다. 즉 관련한 형의 객체를 창조하고 
QApplication： : sendEventO 혹은 QApplication : : postEvent 0를 호출한다. 

sendEventO 는 사건을 즉시 처리한다. sendEventO 가 되돌아올 때 (사건려과 
기와) 객체는 이미 사건에 의하여 처리된다. 많은 사건클라스들에 대하여 호출된 마지막 
처리함수에 의하여 사건을 받아들였는가 거부하였는가를 결정하는 isAcceptedO 라는 함 
수가 있다. 

postEventO 는 후의 발송하기 위한 대기렬에 사건을 기입한다. 다음번에 Qt 의 기 
본사건순환고리를 실행하고 기입된 사건들을 최적화하여 모두 발송한다. 실례로 여러개 
의 크기조절사건들이 있으면 그것들은 하나로 압축된다. 같은것을 그리기사건들에도 적 
용한다. 즉 QWidget :: update 0는 깜빡거림을 최소화하고 여러번의 재그리기를 피하여 
속도를 증가시키는 postEventO 를 호출한다. 

또한 postEventO 는 흔히 객체를 초기화할 때 리용되므로 기입된 사건은 전형적으 
로 객체의 초기화가 완료된 후에 곧 발송된다. 

사용자정의사건들을 창조하려면 QEvent :: Usei •보다 큰 사건번호를 정의할 필요가 
있으며 자기의 사용자정의사건에 대한 특성을 넘기기 위하여 QCustomEvent 의 파생콜 
라스를 만들 필요가 있다 ( QCustomEvent 문서를 참고). 


123 




제 7 절. 건반초점 

Qt 의 창문부품들은 GUI 에 서 습관된 방법 으로 건반초점 을 처 리한다. 

기본문제는 사용자의 건치기가 화면우의 여러 창문들중 임의의것과, 고찰하는 창문 
안의 여 러 창문부품들중 하나에 보내질수 있는것 이 다. 체계는 건치기 가 전달되는것 이 
어느 응용프로그람，그 응용프로그람의 어느 창문, 그 창문의 어느 창문부품인가를 결정 
해 야 한다. 


1. 초생。1동 

특별한 창문부품에로 건반초점을 보내는 방법은 다음과 같다. 

t ) 사용자가 Tab (또는 Shift+Tab 혹은 Enter ) 를 누른다. 

② 사용자가 창문부품을 선택한다. 

③ 사용자가 건반지름건을 누른다. 

④ 사용자가 마우스바퀴를 사용한다. 

⑤ 사용자가 창문에로 초점을 이동하고 응용프로그람은 창문안의 어느 창문부품이 
초점을 엄어야 하는가를 결정한다. 

매 방법 에 대 하여 고찰하자. 

(1) Tab 혹은 Shift + Tab 건을 누른다. 

Tab 누르기는 건반을 리용하여 초점을 옮기는 가장 일반적인 방법이다. 흔히 자료 
입 력응용프로그람들에서 Enter 는 Tab 와 같은 일을 한다. 

Tab 누르기는 일반적으로 사용하는 모든 창문에서 초점이 다음 창문부품으로 이동 
하게 한다. Tab 는 순회목록의 한 방향으로 초점을 이동시키고 Shift + Tab 는 다른 방향 
으로 이동시킨다. Tab 를 누를 때 한 창문부품으로부터 다른 창문부품으로 이동하는 순 
서 를 타브순서 라고 한다. 

어에서 이 목록은 QFocusData 클라스에 보관된다. 창문마다 하나의 QFocusData 
객체 가 있으며 QWidget : : setFocusPolicy () 가 적 당한 QWidget : : FocusPolicy 에 의 
해 호출될 때 창문부품들은 자동적으로 목록의 끝에 추가된다. 
QWidget :: setTabOrder () 를 사용하여 타브순서를 사용자가 정의할수 있다. (그렇게 
하지 않으면 Tab 는 일반적으로 초점을 창문부품을 구성한 순서로 이동시킨다.) Qt 
Designer 는 타브순서를 시각적으로 변경하는 수단을 제공한다. 

Tab 누르기가 아주 일반적이므로 초점을 가질수 있는 대부분의 창문부품들은 타브 
초점을 유지해야 한다. 그러나 드문히 쓰이는 창문부품들과 건반지름건이 있는 창문부품 
으로 초점을 옮기는 오유처 리 함수는 례외 이 다. 

실례로 자료입력대화칸에서 모든 경우의 1%만 필요한 마당이 있을수 있다. 그러한 
대화칸에서 Tab 는 이 마당을 건너쩔수 있고 대화칸은 다음 기구들중 하나를 사용할수 
있 다. 

數 프로그람이 마당이 요구되는지 결정할수 있다면 사용자가 입 력을 끝내 고 OK 를 
누를 때 혹은 사용자가 다른 마당에 대한 조작을 끝낸 후 Enter 를 누를 때 거기로 초점 
을 옮길수 있다. 또는 마당을 타브순서에 포함하지만 그것을 허용하지 않거나 사용자가 
다른 마당들에서 설정한 보기에 적당하면 그것을 허용한다. 

② 마당의 표식은 이 마당에로 초점을 옮기는 건반지름건을 포함할수 있다. 

Tab 기능에 관한 다른 례외는 타브의 삽입을 유지해야 하는 본문입력창문부품들이 
다. 거의 모든 본문편집기는 이 부류에 속한다. 어는 Control + Tab 를 Tab 로서, 
Control + Shift + Tab 를 Shift+Tab 토서 취급하며 그러한 창문부품들은 
QWidget : : event () 를 재정의 하고 QWidget : : event () 를 호출하기전에 Tab 를 처 리 하여 
다른 모든 건들의 표준처리를 엄는다. 그러나 일부 체계가 Control + Tab 를 다른 목적에 
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사용하고 많은 사용자들이 Control+Tab 를 모르므로 이것은 완전한 해결책이 아니다. 

(2) 사용자가 창문부품을 마우스로 선택한다. 

이것은 아마 름퓨터들에서 마우스나 다른 위 치지정 장치 를 리용하여 Tab 를 누르는 
것보다 더 일반적 이 다. 

초점 을 옮기 기 위한 마우스누르기 는 Tab 보다 훨씬 더 강력하다. 초점 을 창문부품 
으로 옮길 때 편집창문부품들에서는 마우스를 누른 곳으로 본문유표(창문부품의 내부초 
점)도 이동한다. 

이것은 아주 일반적이고 사람들이 흔히 사용하므로 대부분의 창문부품들서 그것을 
유지하는것 이 좋다. 그러나 그것을 피하여야 할 중요한 리유도 있다. 즉 초점이 있는 창 
문부품으로부터 초점 을 제 거하려 고 하지 않을수 있 다. 

실례로 문서처리프로그람에서 사용자가 B (강조)도구단추를 마우스로 선택할 때 건 
반초점에 어떤 일이 생기는가? 편집창문부품에서 초점이 있던 곳에 그대로 있어야 하는 
가 혹은 B 단추로 초점을 옮겨야 하는가? 

본문입 력 을 유지 하는 창문부품들에 서 는 초점 에 대 한 누르기 (click-to-focus) 를 유 
지할것 을 권고하고 마우스선택 이 다른 효과를 가지 는 창문부품들에 서 는 그것 을 피할것 을 
권고한다. (또한 단추들에서는 건반지름건을 추가할것을 권고한다. QButton 과 그 파생 
콜라스들은 이것을 아주 쉽게 한다.) 

Qt 에서는 오직 QWidget::setFocusPolicy() 함수가 초점에 대한 누르기에 영향을 
준다. 

(3) 사용자가 건반지름건을 누른다. 

건반지름건들에 대하여 초점을 옮기는것은 례외적인 일이다. 이것은 이행금지대화 
칸을 펼침으로써 암시적으로 발생시킬수 있으나 QLabel::setBuddy() 와 QGroupBox, 
QTabBar 에 의해 제공되는것들과 같은 초점지름건들을 사용하여 명시적으로 발생시킬 
수 있다. 

사용자가 이 행 하려 고 할수 있는 모든 창문부품들에 대 하여 지 름건초점 을 유지할것 
을 권고한다. 실례로 Alt+P 를 누르면 인쇄대화칸이 나타나는것처럼 타브대화칸은 그 매 
개 폐지에 대하여 건반지름건을 가전다. 그러나 이것이 지나쳐서는 안된다. 즉 오직 몇 
개의 건들만 리 용하여 지 령들에 건반지 름건들을 제 공하는것 이 중요하다. 표준지 름건목록 
에서 Alt+P 는 Paste 와 Play, Print, Print Here 에도 사용될수 있다. 

(4) 사용자가 마우스바퀴를 사용한다. 

Microsoft Windows 에서 마우스바퀴의 사용은 늘 건반초점을 가지는 창문부품에 
의해 처리된다. Mac OS 표와 XII에서는 마우스사건들을 엄는 다른 창문부품에 의하여 
처리된다. 

Qt 가 가동환경의 이러한 차이를 처리하는 방법은 바퀴를 사용할 때 창문부품들이 
건반초점을 옮기게 하는것 이다. 매개 창문부품에 대하여 정확한 초점정책을 실시하여야 
응용프로그람들이 Windows 와 Mac OS X, XII에서 정확히 작업할수 있다. 

(5) 사용자가 창문에로 초점을 이동한다. 

이 상황에서 응용프로그람은 창문안의 어느 창문부품이 초점을 받아들여야 하는가 
를 결정해야 한다. 

이것은 간단하다. 즉 초점이 이전에 이 창문안에 있었다면 초점을 가져야 할 마지 
막 창문부품이 그것을 도로 찾아야 한다. Qt 는 이것을 자동적으로 수행한다. 

초점이 이전에 이 창문안에 없었고 초점이 어디서 시작해야 하는지 안다면 
QWidget::show() 하기전에 초점을 받아들여야 하는 창문부품에 대하여 QWidget：： 
se 好' ocusO 를 호출한다. 그렇게 하지 않으면 Qt 는 적당한 창문부품을 선택한다. 
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제 8 절. 표준지름건 


응용프로그람들은 언제나 작용과 련관된 지름건을 정의해야 한다. Qt 는 지름건을 
충분히 지 원한다. 실례 로 QAccel : : shortcuttCey () 를 들수 있다. 

여기에 지름건에 대한 마이크로쏘프트의 권고와 Open Group 의 권고안이 있다. 
대 다수의 지령들에서 Open Group 는 마이크로쏘프트의 권고에 동의하지 않는다. 

강조체 문자 +Alt 는 마이크로쏘프트사의 권고선택 안이다. 실례로 Apply 단추는 
QButton :: setText ( tr ( M & Apply f, ) ) ； 

이다. 

모순되는 지 령(실례로 About 와 Apply) 이 있으면 자체로 결심하여 정 한다. 


About 

Always on Top 

4ppiy 

Back 
Browse 


Open With 
Page Setup 
Paste 
Paste Link 
Paste Shortcut 


Close (CDE: Alt+F4; Alt+F4) 은 창문닫기 Paste Special 

Copy (CDE: Ctrl+C, Ctrl+Insert) Pause 


Copy Here 
Create Shortcut 
Create Shortcut Here 
Cut _ 

Delete 

Edit 

Exit (CDE: Exit) 

Explore 

File 

Find 

Help 

Help Topics 
Hide" 

Insert 

Insert Object 
Link Here 
Maximize 
Minimize 
Move 
Move Here 
New 
Next 
No 
Open 


Play 
Print 

Print Here 
Properties 
Quick View 

Redo (CDE: Ctrl+Y, Shift+Alt+Backspace) 

Repeat 

Restore 

Resume 

Retry 

Run 

Save 

Save As 

Select All 

Send To 

Show 

Size 

Sfilit 

Stop 

Undo (CDE: Ctrl+Z or Alt+Backspace) 
View 

편 hat’s This? 

Window 

Y^s 


또한 다른 많은 건들과 작용 (Alt 가 아니 라 다른 수식건을 리용한다.)들이 있다. 
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제 9 절. Qt Netscape 플라그인확장 

Qt Netscape Plugin 쏘프트웨어는 Netscape, Mozilla 및 Netscape 의 
LiveConnect 통신규약을 유지하는 다른 웨브열람기들에서 Unix/Linux 및 MS- 
Windows 상에서 사용할수 있는 열람기플라그인들을 작성하기 쉽게 한다. 현대판의 
MSIE 는 이 통신규약을 유지하지 않는다. ActiveQt 틀거 리를 사용하여 이 열람기용플라 
그인을 개발한다. 

Netscape 플라그인확장은 다음의 클라스들로 이루어진다. 

• QNPlugin 

• QNPInstance 

• QNPWidget 

• QNPStream 

1. 방법 

# Netscape 로부터 플라그인 SDK 를 내리적재하고 거기에서 

$QTDIR/extensions/ nsplugin/src 에 다음의 파일들을 복사한다. 

• common/npwin. cpp 

• common/npunix. c 

• include/npapi.h 

• include/npupp. h 

• include/jri. h 

• include/jri_md. h 

• include/jritypes. h 

② 자기 Qt 배포물의 extensions/nsplugin/src 등록부에 있는 Netscape Plugin 
확장서고를 구축한다. 이것은 자기의 플라그인코드와 련결될 정적서고를 산출한다. 

③ 플라그인콜라스문서 를 읽 고 실례 플라그인들을 시 험 한다. 

④ 대부분의 개발을 독자적 인 Qt 응용프로그람으로서 수행한다. Netscape Plugins 
의 오유수정 은 시 끄럽다. 자기 플라그인에 서 signal (2) 를 사용하여 자기 열 람기 가 핵 심 
부출력을 금지한다면 그 출력을 가능하게 할수 있다. 

다음에 가동환경에 고유한 구축단계들을 설명한다. 

플라그인에 의해 표시된 파일들이 HTTP 봉사기 (http://... URL 을 사용하여)에 
의해 제공된다면 봉사기는 가령 Apache 의 mime, types 파일을 편집함으로써 그 파일의 
정확한 MIME 형을 전송하도록 환경구성되여야 한다. 파일들이 II ... URL 을 거처서 
표시되 면 열 람기 는 파일 이 름확장자를 사용하여 파일형 과 이 로부터 적재할 플라그인을 결 
정한다. 사용자는 그 열 람기 가 애 호하는 보조프로그람이 나 응용프로그람부분에 서 파일 이 
름확장자를 설정할 필요가 있다. 

1) XII 하에서의 구축 

• 실례의 Makefile 들은 UNIX/X11 에 적합하다. 

• 사용자는 결과에 생기는 공유객체를 열람기의 Plugins 등록부에 설치해야 한다. 

2) Windows 하에서의 구축 

• Netscape 플라그인과 작업 하려 면 Qt 는 체 계 DLL 경 로에 있거 나 정적서고로서 플 
라그인으로 름파일되여야 한다. 

• 플라그인들은 np 지 ■e.dll 로 명명되여야 하며 그렇지 않으면 열람기는 그것들을 
무시 한다. 

• 련결단계는 다음과 같은것을 포함해 야 한다. 

/def : name , def 
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/dll 

플라그인에 의해 받아들인 파일 / MIME 형 을 정 의하는 름파일된 자원파일 . 

• 사용자는 열 람기의 Plugins 등록부에 결과로 생기는 DLL 을 설치해 야 한다 . 

2. 알려진 오유와 제한 

Qt 기초의 LiveConnect Plugin 속박코드는 수많은 오유와 제한을 가지고있으나 많 
은 프로그람제품들에서 충분히 안정하다 . 

• 건반입력은 오직 2 차창문(실례로 플라그인에 의해 창조된 대화칸)들에서 작업한다 . 

• 플라그인과 작업 하려 는 열 람기사이의 양식성 (modality) 을 기 대 하지 말아야 한다 . 

• Unix/Xll 에서 Netscape 4. 78 은 모선오유로 완료되는 경향이 있다 . 

• Opaque 크기 조절 동작은 열 람기 의 동작으로 인 하여 산만스러 워전 다 . 

제10절. ActiveQt 틀거리 

이 모둘들은 Qt Enterprise Edition 의 일부이고 무료 (Free) 혹은 비상업판의 부 
분이 아니다 . 

어의 ActiveX 는 Qt/Windows 개 발자들에게 다음과 같은 일을 가능하게 한다 . 

① Qt 응용프로그람들에 서 ActiveX 봉사기 에 의 하여 제 공된 ActiveX 조종요소들을 
호출하고 리용할수 있게 한다 . 

② Ac 吐 veX 조종요소들과 갈은 많은 량의 Qt 창문부품들을 사용하여 그들의 Qt 응용 
프로그람들을 ActiveX 봉사기로서 쓸수 있게 한다 . 

1. ActiveQt 모듈들 

틀거 리는 두개의 모둘로 이루어 진다 . 

建 ) QAxContainer 

QAxContainer 모둘은 QObject 와 QWidget 보조콜라스들， COM 객체들과 ActiveX 
조종요소들에 용기 로서 작용하는 QAxObject 와 QAxWidget 를 실현하는 정 적서 고이다 . 
공유 Qt 서고에 대 처 하여 구축되 였다면 QAxWidget 는 Qt Designer 에 창문부품플라그인 
으로서 통합된다 . 

또한 그 모둘은 Qt 응용프로그람들에 매몰된 스크립트 COM 객체들에 Windows 
Script Host 기술을 사용할수 있게 하는 콜라스 QAxScript, QAxScriptManager 과 
QaxScriptEngine 을 제공한다 . 

실례에는 Microsoft Internet Explorer 를 매몰하는 웨브열람프로그람과 
Microsoft Outlook 와 내 용을 동기 화하는 주소록실 례 가 포함되 여있 다 . 

© QAxServer 

QAxServer 모둘은 프로쎄스내 및 실행 가능형 COM 봉사기용 기능을 실현하는 정적 
서 고이다 . 이 모둘은 QAxAggregated, QAxBindable 그리 고 QAxFactory 들라스들 
을 제공한다 . 

실례에는 .NET 환경에서 그 객체들을 사용하는 련습은 물론 ActiveX 조종요소들 
과 같은 각이한 QWidget 보조클라스들을 제공하는 프로쎄스내 및 프로쎄스외봉사기들이 
포함되여있다 . 

2. ActiveQt 도구 

다음에 ActiveQt 용도구프로그람들을 보여 준다 . 

DumpDoc 도구 

dumpdoc 도구는 COM 객체용 Qt 형 식문서를 생성하여 지정된 파일에 써 넣는다 . 

표 4 - 5 와 같은 지 령행파라메터를 리용하여 dumpdoc 를 호출한다 . 
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표 4-5. DumpDoc 지 령행 추가선택 


추가선택 

결과 

-o file 

출력을 ///e 에 써 넣는다. 

object 

(9 公 feC 호용문서 를 생 성한다. 

-v 

판정보를 인쇄한다. 

-h 

방조를 인쇄한다 


object 는 국부름퓨터에 설치된 객체이고(즉 원격객체들은 지원하지 않는다) 속성을 
통하여 호출할수 있는 보조객체들을 포함하여야 한다. 즉 

Outlook. Application/Session/ CurrentUser. 

생성된 파일은 Qt 문서형식을 리용하는 HTML 파일일수 있다. 

도구를 구축하려면 우선 QAxContainer 서고를 구축해야 한다. 그다음 

tools/dumpdoc 에서 make 도구를 실행 한다. 

場) IDC 도구 

IDC 도구는 ActiveQt 구축체 계 의 부분으로써 불과 몇 개 행의 코드로 임의의 Qt2 진파 
일 을 완전 COM 객 체봉사기 로 전환한다. 

IDC 는 표 4-6 과 같은 지령행파라메터들을 리해한다. 


표 4-6. 

IDC 지 령 행 추가선택 

추가선택 

결과 

Dll -idl idl - 

봉사기 dll 의 IDL 을 파일 idl 에 써넣는다. 형서 

version x. y 

고는 판 지모를 가전다. 

Dll -tlb tlb 

dll 의 형서고를 tlb 로 교체 한다. 

一 V 

판정보를 인쇄한다. 

-regserver dll 

Register the COM 봉사기 dll 을 등록한다. 

-unregserver 

COM 봉사기 dll 의 등록을 해 제한다. 


일반적으로 IDC 를 수동적으로 호출할 필요가 없다면 cjmake 구축체계는 구축과정에 
필요한 발송 (post) 처 리 의 추가를 고려 해 야 한다 (ActiveQt 구축체 계 문서 참고) . 

遠 ) ActiveX 시험용기 

이 응용프로그람은 ActiveX 조종요소용 일반시험용기를 실현한다. 자기 체계에 설 
치된 ActiveX 조종요소를 삽입하고 메쏘드를 실행하고 속성들을 수정할수 있다. 용기는 
로그창문에서 오유수정출력은 물론 사건과 속성변경에 대한 정보를 기록할수 있다. 

GUI 는 QAxContainer 모둘의 Qt Designer 통합에 의 하여 실현되 였다. 코드부분은 Qt 
메 타객 체 와 Ac 仕 veQt 틀거 리 를 사용하며 응용프로그람코드에 서 사용하지 않는것 이 좋다. 

응용프로그람을 리 용하여 일정 한 ActiveX 의 실례 를 작성할 때 QAxWidget 콜라스 
를 통하여 사용할수 있는 처리부와 신호，속성들을 표시하고 자기가 실현한 ActiveX 조 
종을 시 험하거 나 Qt 응용프로그람에 서 사용하려 고 한다. 

응용프로그람은 적재된 조종요소들을 프로그람작성 하는데 JavaScript 와 VBScript, 
Perl, Py 比 ion 으로 되 여있는 스크립 트파일들을 적재 하고 실 행할수 있 다. QAxWidget2 
콜라스를 사용하는 실 례 스크립 트파일 들은 scripts 보조등록부에 서 리 용할수 있 다. 

이 실례의 qmake 프로젝트는 판자원을 가진 자원파일 testcon.rc 를 포함한다. 이 
것은 일부 ActiveX 조종요소(실례로 Shockwave ActiveX 조종요소)에 요구되며 그것 
은 그러한 판정보가 없으면 중단하거 나 오동작할수 있다. 

도구를 구축하려면 우선 QAxContainer 서고를 구축해야 한다. 그다음 
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tools / testcon 에서 make 도구를 실행한 결과 만들어지는 testcon . exe 를 실행한다. 


제 11절. Qt Motif 확장 

이 모둘은 Qt Enterprise 판의 부분이며 무료 혹은 비상업판의 부분이 아니 다. 

1. 소개 

Qt Mo 吐 f 확장은 낡은 Xt 와 Motif 기 초응용프로그람들과 더 편리한 Qt 도구일식 의 
통합을 방조한다. 이 확장은 어의 초기판들에 포함된 낡은 Xt/Motif Support 
Extension 을 교체한다. 

Qt Motif 확장은 다음의 들라스들로 이루어진다. 

• QMotif - Qt Motif 확장의 기초를 제공한다. 

• QMotifWidget - Motif 창문부품용 QWidget API 를 제공한다. 

• QMotifDialog - Motif 대 화칸용 QDialog API 를 제 공한다. 

• QXtWidget -이전의 Xt/Motif 확장으로부터 Xt/Motif 통합. 이 클라스는 유지 되 
지 않고 수많은 문제들과 제 한들이 알려져 있다. 이것은 현존원천작업을 유지할 목적으로 
만 제공된다. 이것을 새 코드에서 사용하지 말아야 한다. 

2. 일반문제 

€) 부정확한 CDE 색구조 

QMotifWidget 와 QMotifDialog 는 QApplication 가 사용하는것과 같은 시각적인 
색략도와 색깊이를 사용한다. CDE 를 사용할 때 색구조는 기정이 아닌 시각적인 색략도 
와 색깊이를 사용할 때 정확하지 않을수 있다. 이 문제를 처 리하려면 기동파일 
($ HOME /. dt / sessions / current / dt . resources ) 에 다음과 같은 자원문자렬을 추가하 
여 야 한다. 

* userColorObj : false 

種) XII 머리부충돌 

XII 머 리부들은 Qt 머 리부들과 충돌하는 일부 상수들을 정의한다. 해결책은 우선 
Qt 머리부들을 포함하고 뒤이어 이 확장의 머리부들을 포함하고 다음에 모든 Xt/Motif 
와 XII 머 리 부들을 포함하는것 이 다. 실 례 로 
// Qt headers first 
#include <qapplica 仕 on . h > 

#include < qpushbutton . h > 

#include < qsocket . h > 


// QMotif * headers next 
#include < qmotif . h > 
#include < qmotifdialog . h > 
#include < qmotifwidget . h > 


// Xt/Motif and XI 1 headers last 
#include < X 11/ Xlib . h > 

#include < Xt / Intrinsic . h > 
#include < Xm / Xm . h > 
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③ 여러화면지원 

QMotifWidget 를 QDesktopWidget 와 함께 사용하여 여러 화면에 제일 웃준위창 
문들을 창조할수 있다. 일반적인 오유는 비기정화면우에 QMotifWidget 를 창조하고 
Xt/Motif 창문부품들을 기 정 화면우에 창조하는것 이 다. 해 결 책 은 QMotifWidget 와 
Xt/Motif 자식을 둘다 지정하는것이다. 실례로 

Display *dpy = QApplication ： : desktop()->xllDisplay() ； 

Arg args[l]; 

// QMotifWidget 와 XmMainWindow 이 둘다 화면 1 에 있다는것을 확인한다 
XtSetArg(args[0] , XtNscreen, ScreenOfDisplay(dpy , 1)); 

QMotifWidget *toplevel = new QMotifWidget (QApplication :: desktop () - 
>screen(l), 

xmMainWindowWidgetClass, args, 1, "mainwindow") ； 

3. QMotif 기능확장 

다음의 실례프로그람들은 낡은 Xt 와 Motif 기초코드를 더 편리한 Qt 도구일식에로 
통합과정을 방조하는 QMotif 의 사용법을 설명한다. 

1) Motif 사건순환고리의 사용 

머리 부파일 

Sifndef MAINWINDOW_H 

#define MAINWINDOW_H 


#include <qmainwindow. h> 
class QMotifWidget ； 

class MainWindow : public QMainWindow 

{ 

public ： 

MainWindow () ； 
private : 

QMotifWidget *customwidget; 


#endif // MAINWINDOW_H 
실현파일 

#include "mainwindow. h M 
#include <qapplication.h> 
#include <qmotif. h> 


int main( int argc, char **argv ) 

{ 

XtSetLanguageProc( NULL, NULL, NULL )； 

QMotif integrator( "customwidget" ); 
QApplication app( argc, argv ) ； 
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MainWindow main window ； 

app . setMainWidget ( Smainwindow ) ； 

main window . showO ； 

return app . exec () ； 


#include " mainwindow . h M 
#include < qapplication . h > 

#include < qmenubar . h > 

#include < qpopupmenu . h > 

#include < qstatusbar . h > 

#include < qmotifwidget . h > 

#include < Xm / Form . h > 

#include < Xm / PushB . h > 

#include < Xm / Text . h > 

MainWindow ： : MainWindow () : QMainWindow ( 0， " mainwindow " ) 

{ 

QPopupMenu *filemenu = new QPopupMenu ( this ) ； 

filemenu -> insertltem ( tr ("技 Quit ”), qApp , SLOT ( quitO ) ) ； 


menuBar () - > insertltem ( tr ("技 File ”), filemenu ) ； 

statusBar () - > message ( tr( M This is a QMainWindow with an XmText widget . M ) )； 
customwidget = new QMotifV \ Tidget ( this , xmFormWidgetClass , NULL , 0，” form " ); 


XmString str ； 
Arg args [6]; 


str = XmStringCreateLocalized ( "Push Button ( XmPushButton )’’ ) ； 
XtSetArg ( args [0], XmNlabelString , str ) ； 

XtSetArg( args[l], XmNleftAttachment, XmATTACH_FORM )； 
XtSetArg( args [2], XmN right Attachment, XmATTACH_FORM ) ； 
XtSetArg( args [3], XmNbottomAttachment, XmATTACH_FORM ) ； 
Widget button = 

XmCreatePushButton ( customwidget -〉 mottfWidgetO , ’’Push Button ", args , 4 )； 
XmStringFree ( str ) ； 


XtSetArg ( args [0], 
XtSetArg ( args [ l ], 
XtSetArg ( args [2], 
XtSetArg ( args [3], 
XtSetArg ( args [4], 
XtSetArg ( args [5], 


XmNeditMode , XmMULTI _ LINE_EDIT ) ； 
XmNleftAttachment , XmATTACH_FORM )； 
XmNrightAttachment , XmATTACH 一 FORM ) ； 
XmNtopAttachment , XmATTACH_FORM ) ； 
XmNbottom Attachment , Xm ATT ACH_WIDGET ) ； 
XmNbottom Widget , button ) ； 
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Widget texteditor = 

XmCreateScrolledTextC customwidget -> motifMdget (), "Text Editor ", args 

XtManageChild ( texteditor ) ； 

XtManageChild ( button ) ； 

setCentralWidget ( customwidget ) ； 


resize ( 400, 600 ); 

} 

2) Motif 대 화칸 

머리 부파일 

#ifndef MAINWINDOW.H 
#define MAINWINDOW.H 
#include < qmotifwidget . h > 

class MainWindow : public QMotifWidget 

{ 

public ： 

MainWindow 0; 

void showMotifDialog () ； 

void showQtDialogO ； 


#endif // MAINWINDOW_H 
실현 파일 

#include < qapplication . h > 
#include < qmotif . h > 
■elude " mainwindow . h M 


int main ( int arge , char **argv ) 

{ 

XtSetLanguageProc ( NULL , NULL , NULL )； 

QMotif integrator ( ’’ dialog ’’ ) ； 

QApplication app ( arge , argv ) ； 

MainWindow main window ； 

app . setMainWidget ( Smainwindow ) ； 

main window . showO ； 

return app . exec () ； 


#include " mainwindow . h M 
#include " dialog , h ” 
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#include < Xm / MainW . h > 
#include < Xm / RowColumn . h > 
#include < Xm / CascadeB . h > 
#include < Xm / PushB . h > 
#include < Xm / PushBG . h > 
#include < Xm / SeparatoG . h > 
#include < Xm / Text . h > 
#include < Xm / MessageB . h > 
#include < Xm / Form . h > 
#include < Xm / LabelG . h > 


#include < qapplication . h > 

static void mottfDialogCallback ( Widget , XtPointer client _ data , XtPointer ) 

{ 

Main Window *mw = (MainWindow *) client _ data ； 
mw->showMotifDialog () ； 

} 

static void qtDialogCallback ( Widget , XtPointer client _ data , XtPointer ) 

{ 

MainWindow *mw = (MainWindow *) client _ data ； 
mw->showQtDialog () ； 


static void quitCallback ( Widget , XtPointer client _ data , XtPointer ) 

{ 

MainWindow *mw = (MainWindow *) client _ data ； 
mw -> close () ； 


MainWindow :: MainWindow () 

: QMotifWidget ( 0, xmMainWindowWidgetClass , NULL , 0, 

main window ’’ ) 

{ 

Widget menubar = XmCreateMenuBar ( mo 仕 fWidgetO , ’’ menubar ”, NULL , 0 )； 
Widget filemenu = XmCreatePulldownMenu ( menubar , " filemenu ", NULL , 0 )； 
Widget item ； 

item = XtVaCreateManagedWidget ( "Motif Dialog ...’’, 

xmPushBu 仕 onGadgetClass , filemenu , XmNmnemonic , ’ C ’, NULL ); 
XtAddCallback ( item , XmNactivateCallback , mottfDialogCallback , this ) ； 

item = XtVaCreateManagedWidget ( ” Qt Dialog ...’’, 

xmPushButtDnGadgetClass , filemenu , XmNmnemonic ,， Q 、 NULL ); 
XtAddCallback ( item , XmNactivateCallback , qtDialogCallback , this ) ； 
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item = XtVaCreateManagedWidget ( ’’sep”, xmSeparatorGadgetClass, 

filemenu, NULL) ； 

item = XtVaCreateManagedWidget( ’’Exit”, 

xmPushButtonGadgetClass, 典 lemenu, XmNmnemonic, ’x’, NULL); 

XtAddCallback( item, XmNactivateCallback, quitCallback, this ) ； 

XmString str = XmStringCreateLocalized( ” File” ) ； 

item = XtVaCreateManagedWidget( ’’File”, xmCascadeButtonWidgetClass, 
menubar, XmNlabelString, str, XmNmnemonic, ’F ’， XmNsubMenuId, 
filemenu, NULL ) ； 

XmStringFree( str ) ； 


Arg args[2]; 

XtSetArgC args[0], XmNeditMode, XmMULTI_LINE_EDIT )； 

Widget texteditor = XmCreateScrolledText( motifWidgetO, ’’texteditor”, 
args, 1 ) ； 


XtManageChild ( menubar ) ； 

XtManageChild( texteditor ) ； 

// pick a nice default size 

XtVaSetValues( motif Widget 0, XmN width, 400, XmNheight, 300, 
NULL ); 

setCaption( tr(’’QMotif Dialog Example") ) ； 


void MainWindow :: showMotifDialog () 

{ 

QMotifDialog dialog( this, "custom dialog", TRUE ) ； 
dialog. setCaption( tr( M Custom Motif Dialog") ); 

Widget form = XmCreateForm( dialog.shell(), ’’custom motif dialog", 
NULL, 0 ) ； 

XmString str ； 

Arg args [9] ； 

str = XmStringCreateLocalized( ’’Close” ) ； 

XtSetArgC args [0], XmNlabelString, str ) ； 

XtSetArgC args[l], XmNshowAsDefau 11, True ) ； 

XtSetArg( args [2], XmNleftAttachment, XmATTACH_POSITION ) ； 
XtSetArgC args [3], XmNleftPosition, 40 ) ； 

XtSetArgC args[4], XmNrightAttachment, XmATTACH_POSITION )； 
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XtSetArg( args [5] , XmN right Position , 60 ) ； 

XtSetArg( args [7], XmNbottomAttachment, XmATTACH 一 FORM ) ； 
XtSetArg( args [6], XmNtopOffset, 10 ) ； 

XtSetArg( args [8], XmNbottomOffset, 10 ) ； 

Widget button = XmCreatePushButton( form, ’’Close”, args, 9 ) ； 
XmStringFree( str ) ； 


str = XmStringCreateLocalized( ’’This is a custom Motif-based dialog 
using\n M "QMotifDialog with a QWidget - based parent. ’’ ) ； 

XtSetArg( args [0], XmNlabelString, str ) ； 

XtSetArgC args[l], XmNleftAttachment, XmATTACH_FORM ) ； 
XtSetArg( args[2], XmNrightAttachment, XmATTACH.FORM )； 
XtSetArg( args [3], XmNtopAttachment, XmATTACH_FORM ); 
XtSetArgC args [4], XmNbottomAttachment, XmATTACH_WIDGET ) ； 
XtSetArg( args [5], XmNbottomWidget, button ); 

XtSetArgC args [6], XmNtopOffset, 10 ) ； 

XtSetArg( args [7], XmNbottomOffset, 10 ) ； 

Widget label = XmCreateLabelGadget( form, "label", args, 8 ) ； 
XmStringFree( str ) ； 


XtManageChild( button ) ； 
XtManageChild( label ) ； 
XtManageChild( form ) ； 


XtAddCallback( button, XmNactivateCallback, 

(XtCalIbackProc) QMotifDialog ： : acceptCallback, 技 dialog ); 

dialog, exec () ； 

} 


void MainWindow： : showQtDialogO 

{ 

// custom Qt-based dialog using a Motif-based parent 
CustomDialog customdialog( motifWidgetO, "custom dialog”, TRUE ); 
customdialog. execO ； 


4. Qt Motif 확장-이 식단계 

여기서는 Qt Motif 확장을 리용하여 Motif 에 기초한 프로그람을 Qt 도구일식으로 
완전히 이 식 하는 방법 을 설명한다 . 

수십만행 지어는 수백만행의 코드를 가지는 큰 프로젝트를 한번에 이식하는 일이 
드문히 있으며 그러한 시도는 아주 많은 개 발자원을 요구하며 중요한 위험 을 초래 한다 . 
코드의 각 행은 다시 씨야 할수 있고 각 사용자대면부를 다시 설계하고 질담보검사와 수 
속을 모두 다시 씨야 할수 있다 . Qt Motif 확장은 매개의 개별적인 프로젝트와 유효자원 
에 적 당한 증분이식을 위한 완전하고도 동작하는 대책을 제공한다 . 사용자대면부와 관련 
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코드는 여러 걸음에 이식될수 있고 나머지 프로젝트는 전혀 변경할 필요가 없다 . 

이 설명 은 현존 Motif 기 초프로젝 트를 Qt 도구일식 에 이 식하는 프로그람작성 자용이 다 . 
여기서는 프로그람작성자들이 C/C++ 와 Xt/Mo 吐 f 에 대한 경험이 있으리라고 생각한다 . 
또한 Qt 도구일식에 대한 경험도 필요하다 . 

-이 설명의 목적 

이 설명 의 목적 은 Motif 응용프로그람을 Qt 도구일 식 에 통합하기 위한 충분한 지 식 
을 독자들에 게 제 공하는것 이 다 . 실례 를 들어 설명한다 . 실제 의 Motif 기 초프로그람을 한 
걸 음씩 전환한다 . 이 걸 음은 두가지 기 술과 그 관계 를 처 리 과정 을 통하여 설명한다 . 

이 식 프로젝 트로서 Motif 2. x 배 포물에 포함되 는 todo 시 위 프로그람을 사용한다 . 이 
설명은 extensions/motif/examples/walk 比 trough 보조등록부에 포함되는 원천코드에 
로의 참고를 포함한다 . 

- 필수조건 

Qt Motif Extension 의 사용을 시작하기전에 다음의 요구를 만족시켜야 한다 . 

i) X11R6.X 와 Motif 2.x 서고들을 사용하고있다 . 

② 프로젝트는 C++ 름파일러와 호환될수 있다 . 

③ Qt Motif Extension 을 구축하고 설치 하였다 . 

④ 프로젝트를 Qt 도구 및 Qt Motif Extension 과 함께 구축 및 련결하였다 . 

X11R6.X 과 Motif 2.x 서고 

Qt Motif Extension 이 사용한 기구들은 X11R6 출하물과 Motif 2.0 출하물로부터 
개발머 리부와 서고들을 요구한다 . 더 새로운 판을 사용할수도 있다 . 

C ++ 콤파일 러 

Qt 는 C++ 도구이 므로 모든 새 코드는 C++ 로 씌여 진다 . 현존코드를 새 코드와 공존 
하기 위하여 C++ 틈파일 러 는 현존코드를 콤파일 할수 있어 야 한다 . 

현존코드와 새 코드를 따로따로 유지할수 있고 현존코드를 필요할 때 변환하거 나 
다시 쓸수 있다 . 이것은 이식과정의 표준부분이고 이식을 시작하기전에 수행할 필요는 
없다 . 이것은 가장 일반적인 대본이고 현존 C 코드를 이 설명에서 필요할 때 C++ 에 이식 
하여 보여준다 . 

Qt Mo 仕 f 확장의 구축 및 설치 

Qt Motif Extension 은 Qt 도구와 함께 구축하고 설치되지 않는다 . 이 확장은 
extensions/motif 보조등록부에 있다 . 이 동록부에서 make 를 실행하여 확장과 실례들 
을 구축한다 . 일단 확장이 구축되였으면 make install 을 실행한다 . 

$ cd extensions/motif 
$ make 

$ make install 

현재 Qt Motif Extension 가 설치되고 사용할 준비가 되였다 . 

프로젝트를 Qt 도구 ， Qt Motif 확장을 가지고 구축 및 련결 

간단히 qmake 로 Makefile 을 창조한다 . -project 선택은 qmake 가 자동적으로 프로 
젝트파일을 생성하게 하나 . qmake -project 가 프로젝트파일을 생성한 다음 qmake 를 
다시 실행하여 Makefile 을 생성한다 . 이제는 make 를 실행하여 프로젝트를 구축할수 있 
다 . 

$ qmake -project 
$ qmake 
$ make 

정 확히 구축되 였지 만 Motif 서 고와 련결하지 못하여 련결 이 실패한다 . 프로젝 트파일 
에서 LIBS 변수에 -lXm 를 추가하여 qmake 가 이것을 하게 한다 . 이 프로젝트에서 Qt 
Motif Extension 을 사용할 예정이므로 또한 서고목록에 -lqmotif 를 추가해야 한다 . 
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LIBS += -lXm -lqmotif 

그러면 qmake 를 다시 실행하여 Makefile 를 다시 생성하고 make 로 다시 구축한 
다. 이번에 프로젝트는 성공적으로 련결하고 응용프로그람은 기대한대로 실행된다. 

이제는 Qt Motif Extension 을 리용할 준비가 되였다. 

1) 시작하기 

QMotif 와 QApplication 로 시 작 

Qt 를 사용하기 위 하여 하나의 QApplication 객체를 창조해야 한다. QApplication 
콜라스는 사건의 모든 배포를 조종하고 다른 모든 Qt 객체들과 창문부품들의 관리를 현 
시한다. QMotif 콜라스를 Qt Motif Extension 으로부터 리용하여 QApplication 과 
XtAppContext 이 공존하게 한다. 

^ Application 객체는 main() 함수에서 창조되여야 한다. C ++ 틈파일러에서 름파일하 
도록 todo.c 를 수정 하여 야 하므로 todo.c 를 todo.cpp 로 이 름을 바문다. 

다음으로 QMotif 와 QApplication 클라스용의 적 당한 머 리부를 추가한다. 

다음으로 QMotif 와 QApplica 仕 on 객체들을 창조한다. 외부 XtAppContext 을 가지고 
QMotif 를 창조하고 외부 Display 를 가지고 QApplication 을 창조한다. 

다음의 변경은 아직 필요없지 만 Qt Motif Extension 이 완전한 통합을 제 공한다는것 을 
보여 주기 위 하여 포함된 다. 보통 Motif 기 초프로그람은 XtAppMainLoopO 함수를 리 용하여 
응용프로그람의 사건순환고리를 실행한다. 이것은 여전히 가능하지만 Qt 도구에 이식하 
고있으므로 사건순환고리실행 에 QApplication :: exec 0함수를 리용하는것 이 좋다. 

todo.c 를 todo.cpp 으로 이름을 바꾸었으므로 프로젝트파일을 변경하고 qmake 를 재실 
행하여 Makefile 을 다시 생성해 야 한다. 프로젝트를 구축할 때 름파일 및 련결오유들이 
있으며 다음 절에서 이것들을 고찰한다. 

② C ++ 에 로 이식 

이 파일의 코드를 적당한 C ++ 코드로 변환하여야 한다. 다행히도 변경은 그리 크지 
않다. 현존 C 프로젝트들로부터 포함한 대부분의 파일들은 C ++ 에 호환되지 않으므로 
extern "C” 블로크에 그것 들을 포함하여 호환되 게 만든다. 

또한 앞방향선언되 는 대 역 C 함수들은 extern "C” 블로크에 포함해 야 한다. 

manageCB() 함수는 적 당한 C++ 로 변환할 필요가 있다. 

그리 고 2 개 의 무효한 강제변환을 고착시 켜 야 한다. 하나는 Save() 함수에 있 다. 

다른 무효한 강제변환은 Open() 함수에 있 다. 

이 변경후에 프로젝 트를 틈파일 하고 련결 하며 응용프로그람을 정 확히 실 행 하고 연 
산한다. 

2) 사용자대면부의 이식준비 

프로젝트용 사용자대면부를 이식할 준비가 되였다. 소개에서 언급한것처럼 여러 걸 
음에 이것 을 수행하여 응용프로그람이 여전히 이 식과정의 매 개 단계 에서 사용할수 있도 
록 한다. 

사용자대 면부는 계 층으로 고찰할수 있으며 매 개 제 일 웃준위창문과 대 화칸은 부모 
(다른 제 일 웃준위창문이 나 대 화칸) 에 의 존한다. Motif XmMainWindow 창문부품을 리용 
할 때 이것은 2개의 개별적인 실체들로 고찰되여야 한다. 즉 올리펼침차림표계층을 가 
진 기 본창문창문부품과 기 본창문창문부품에 포함된 보기창문부품. 보기창문부품은 기 본 
창문창문부품에 의존한다. 

의존관계 를 가지지 않는 부분들을 이 식하기 시 작하며 모든 부분을 이식할 때 까지 
아주 훌륭한 의존관계나무와 작업한다. 

프로젝트의 계층은 다음과 갈다. 
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그림 4-1. 프로젝트의 계층 

모든 대화칸，다음에 올리펼침차림표계층을 가지는 기본창문창문부품，끝으로 보기 
창문부품의 이식과 교체를 한다. 

그러나 아직 시작할 준비가 안되였다. 이식과정은 오렐수 있지만 어렵지는 않다. 
Open , Save As , Page Delete 그리고 IO Error 대화칸들은 Motif 
XmFileSelectionBox 과 XmMessageBox 대화칸을 사용한다. 아는 즉시 리용할수 있는 
QFileDialog 와 QMessageBox 와 류사한 기능을 제공한다. 

하지 만 Print 대 화칸은 특수하다. Print 대 화칸은 View 창문부품을 교체 할 때 까지 
교체될수 없다. Qt 는 QPrinter 에 의하여 완전한 인쇄기구를 제공하지만 View 창문부품 
을 교체할 때 까지 그 리 용을 시 작할수 없 다. 

必 Help 대화칸의 삭제 

Help 대 화칸도 역 시 특수하다. Help 대 화칸을 사용자정 의 QDialog 로 교체 할 대 신에 
Qt 방조체계클라스들을 리용하여 더 고급한 직결방조를 제공할수 있다. 그러나 Main 
Window 및 View 창문부품들을 교체 할 때까지 QToolTip , QWhatsThis 와 같은 콜라 
스의 리용을 시 작할수 없다. 

원시프로젝트들에 포함된 방조본문은 아주 적고 오직 XmNoteBook 창문부품에 대 
한 정보만 포함한다. 도구암시와 whats - 仕 iis 본문의 사용은 이 실례에 충분하다. 자기의 
이식프로젝트가 큰 직결방조체계를 가지고있다면 초본문항행과 완전인쇄기능을 가지는 
풍부한 본문방조체계구축방법에 대한 정보를《 간단한 HTML 방조열람기》실례를 통하 
여 혹은 Qt Assistant 를 리용하여 볼것을 권고한다. 

현존 Help 대화칸의 삭제는 상대적으로 간단하다. 프로젝트파일에서 Xmd / Help . h , 
Xmd / HelpP.h 그리고 Xmd / Help . c 파일들을 삭제하고 Makefile 을 다시 생성 한다. 

Help 차림표와 Help 대화칸을 창조하는 코드는 todo.cpp 에 있다. Xmd / Help.h 머 
리 부， * help_manager 자원문자렬, help _ cb () 함수앞방향선언과 help_widget 대역 변수 
를 삭제한다. 또한 Help 대화칸을 창조하는 코드를 삭제한다. 또한 Help 차림표를 창조 
하는 코드를 삭제하여 차림표를 비운다. 끝으로 help _ cb () 함수실현을 삭제한다. 

Help 대화칸은 현재 프로젝트에서 삭제된다. 육전히 기본창문창문부품에 순간에 
XmMainWindow 을 사용하므로 QToolTip 와 QWhatsThis 방조를 추가할수 있다. 기 
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본창문과 올리 펼 침 차림 표계 층을 이 식하였 다면 직 결 방조에 QToolTip 와 QWhatsThis 을 
리용할수 있다. 

3) Qt 표준대화칸의 리용 

Qt 표준대화칸: QFileDialog 와 QMessageBox 의 리용을 시 작한다. 두 콜라스는 쓸 
모있는 정적편의함수들을 제공한다. 


표 4-7. QFileDialog 와 QMessageBox 의 정 적 편의함수들 


QFileDialog ： : getOpenFileName() 

Open 대화칸의 교체 

QFileDialog ： : getSaveFileName() 

Save As 대 화칸의 교체 

QMessageBox ： : information() 

Page Delete 대화칸의 교체 

QMessageBox： : warning 。 

IO Error 대 화칸의 교체 . 


매개 함수는 QWidget *parent 인수를 가진다. parent 인수로서 0 을 넘기면 기본창 
문의 중심에 배치되지 않고 화면의 중심에 배치된 대화칸들을 가전다. 
XmMainWindow 를 창조하는 QMotifWidget 를 가지고 이 콜라스를 Motif 대화칸와 
Qt 대화칸들에 부모로서 사용할수 있다. 

todo.cpp 에서 QMo 仕 fWMget 와 QFileDialog 용의 적당한 머리부를 포함하여야 한다. 

다음으로 응용프로그람의 초기 화방법 을 약간 수정한다. Xt/Motif 를 초기 화하고 자 
체로 XtAppContext 를 창조할수 있지만 QMo 吐 f 는 이것을 할수 있다. 또한 
(^Application 가 X 봉사기에로의 련결을 열게 한다. 다음에 

xinMainWindowWidgetClass 를 widgetclass 인수로서 넘기여 QMotifWidget 를 창조 
한다. 이제는 QMotifWidget: :motifWidget() 함수를 사용하여 Motif 창문부품을 호출할 
수 있 다. 월 창문부품은 QMotifWidget 에 의 하여 자동적으로 창조된다. XtParentO 를 
리용하여 그것을 호출한다. 제일웃준위창문은 현재 QMotifWidget 이며 이것은 Qt 표준 
대화칸에 부모로서 리용할수 있다는것을 의미 한다. 

. ■$) Open 과 Save As 대 화 칸의 교체 

우선 현존 Motif 파일선택대화칸의 모든 코드를 삭제한다. Xm/FileSB.h 머리부，대 
역변수 file_dialog 그리고 대화칸을 창조하는 코드를 삭제한다. 또한 
Presen1;FDialog() 역 호출함수를 삭제 한다. 이 코드는 QFileDialog 의 사용에 하나도 필 
요없다. 

PresentFDialogO 역 호출함수를 삭제 한 다음 Open 과 Save As 올리 펼침 차림 표역 호 
출이 OpenO 과 SaveO 함수들을 호출하게 만든다. 

우선 두 함수의 선언을 변경해야 한다. 

또한 인수들을 역호출로 변경한다. 제일웃준위 QMotifWidget 를 이 함수들에 
client_data 로 넘 기므로 그것을 QFileDialog 용 부모로 리 용한다. 

다음으로 SaveO 함수를 QFileDialog: :getSaveFileName() 를 사용하도록 수정 한다. 

그리 고 OpenO 함수를 QFileDialog: :getOpenFileName() 를 리 용하도록 수정 한다. 

프로젝트를 구축한 후에 응용프로그람을 실행하면 기대한대로 동작한다. Open 과 
Save As 대화칸이 현재 QFileDialog 를 사용한다. 

■② Page Delete 와 IO Error 대 화칸의 교체 

Page Delete 대화칸이 창조되고 actions.c 에서 사용된다. 이 파일을 C++ 로 이식할 
필요가 있다. 이름을 actions.cpp 로 변경하고 프로젝트 파일을 수정하고 Makefile 을 다 
시 생성 한다. 

ac 吐 ons.cpp 를 름파일하는데 필요한 변경은 적다. C 머리부파일들과 대역변수들을 
extern ” C’’ 블로크에 포함하여야 한다. 

NewPageO, DeletePageO , EditPageO and SaveltO 함수들을 앞방향선언하여 
틈파일러 가 이 함수들의 정확한 기 호들을 생성 하게 한다. 
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하나의 무효지적자강제변환을 고착해 야 한다. 

그리고 TrimO 함수에서 변수 new 를 newstr 로 변경해야 한다. 

이제는 DeletePageO 함수를 QMessageBox ： : information ()# 리용하도록 변경 하 
여 야 한다. 

우선 QMessageBox 의 적 당한 머 리부를 포함하는가 확인한다. 

이 시점에서 코드에서 폐지가 삭제되여야 한다. 이것을 수행하는 코드는 
DoDeletePageO 함수에 있다. DoDeletePageO 의 내용을 이 점으로 이동하고 
DoDeletePageO 함수를 완전히 삭제한다. 

다음에 todo.cpp 를 변경 하여 제일 웃준위 QMo 吐 fWidget 를 client_data 로서 

DeletePageO 함수에 넘긴다. 

IO Error 대화칸이 창조되고 io . c 에서 리용된다. 이 파일을 C ++ 로 이식해야 한다. 
그것을 io . cpp 로 변경하고 프로젝트파일을 수정하고 Makefile 을 다시 생성한다. 

io . cpp 을 를파일하게 하는데 필요한 변경은 극히 적다. C 머리부파일들과 대역변수 
들을 extern " C " 블로크에 포함해 야 한다. 

ReadDBO 와 SaveDBO 함수들을 앞방향선언하여 를파일러는 이 함수들에 정확한 
기 호들을 생성한다. 

ParseNewLinesO 함수는 적당한 C ++ 로 전환하여야 한다. 

또한 PrintWithNewLinesO 함수는 적당한 C ++ 로 변환해 야 한다. 

이제는 ReadDBO 와 SaveDBO 함수들을 변경하여 QMessageBox : : warning 0를 
사용할수 있다. 

우선 QMessageBox 용 적 당한 머 리부를 포함하는가 확인한다. 

프로젝트를 구축한 다음 응용프로그람을 실행하면 기대한대로 동작한다. 차이는 
Page Delete 와 IO Error 대화칸이 현재 QMessageBox 를 사용한다는것 이 다. 

4) 사용자정의 QDialog 의 리 용 

표준대화칸을 교체한 후에 사용자정의대화칸들로 이동한다. 이 프로젝트는 단일사 
용자정 의 대 화칸 Page Edit 대 화칸을 가진 다. 

코드를 자체로 작성하지 않고 Qt Designer 로 대화칸을 설계한다. 사용자정의대화 
칸설계 는 이 문서 의 범 위밖에 있 다. 

鐘) Page Edit 대화칸의 교체 

Page Edit 대화칸용 사용자정의 QDialog 서술은 pageeditdialog . ui 에 보관된다. 다 
음 행을 추가하여 프로젝트 파일. pro 에 이 파일을 추가한다. 

FORMS = pageeditdialog . ui 

그리고 Makefile 을 다시 생성한다. uic 편의프로그람은 사용자정의 QDialog 코드를 
생성하고 그다음 콤파일하여 응용프로그람에 련결한다. ( uic 는 . pro 파일들로부터 생성 
된 makefile 들로부터 자동적으로 호출된다.) 

제일웃준위 QMo 吐 fWidget 를 EditPage 함수에로의 client _ data 인수로 넘기여 새로 
운 PageEditDialog 의 부모로 리용할수 있다. todo . cpp 에서 Open 과 Save As 대화칸 
에서와 갈은 방법으로 이것을 수행한다. 

EditPageO 함수는 actions . cpp 에 실현된다. PageEditDialog 와 QLineEdit 에 필 
요한 머 리부를 추가하는것으로 시 작한다. 

EditPageO 함수에서 PageEditDialog 를 창조하고 3개의 QLineEdit 창문부품들의 
초기값을 현재 폐지로부터 들어온 값들로 설정하고 대화칸을 실행 한다. 

이 시점에서 코드에서 폐지속성들은 수정되여야 한다. 이것을 수행하는 코드는 
DoEditPageO 함수에 있다. DoEditPageO 의 내용을 이 점으로 이동하고 

DoEditPageO 함수를 완전히 삭제한다. 

page . 노에 정의된 Page struct 는 char * 배렬에 문자렬들을 보관한다. 
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PageEditDialog 와 그것이 포함하는 자료가 이 함수로부터 돌아올 때 파괴되므로 국부 
부호화에서 유니코드 QString 자료를 QCString 으로 변환하고 그것을 duplicate it 
with qs 比 dup () 를 가지고 복사할 필요가 있다. 

같은 과정을 minorTab 본문에 대해서도 수행하고 majorTab 본문에 대해서도 수행 
한다. 

5) QMotifDialog 에서 현존대화칸 리 용 

이미 언급한것처럼 Print 대화칸은 View 창문부품으로 변환될 때까지 교체될수 없 
다. Print 대화칸은 이식을 끝낸 다음에 QPrinter 를 그대신 사용하므로 삭제된다. 이 
정 보에 기 초하여 Print 대 화칸을 사용자정 의 QDialog 로 교체 할만한 가치 가 없 다고 생 각 
한다. 그대신에 Motif 기초대화칸을 유지하고 QMotifDialog 를 리용하여 대화칸을 응용 
프로그람과 통합한다. 

必 양식성요구 

QDialog 에서 양식 성은 Motif 와 다르다. QDialog : : exec 0 함수는 대화칸이 끝날 
때까지 돌아오지 않는다. Motif 에서 이행금지성은 단지 월의 속성이고 프로그람작성자 
는 그 동작을 요구한다면 QDialog : : exec () 형 식 을 리 용해 야 한다. 

QMotifDialog (QDialog 의 파생 콜라스) 를 사용하므로 QMotifDialog 와 통합하는 
각 대화칸에 대하여 accept 와 reject 역호출을 가져야 한다. 미리 정의된 Motif 대화칸은 
그것을 이미 가지고있 다. 즉 XmNokCallback 과 XmNcancelCallback 역 호출. 그러나 
Print 대화칸은 오직 accept 역 호출 ( XmdNprintCallback ) 만 가지고 reject 역 호출은 가 
지지 않는다. 이것을 추가해야 한다. 

이것은 간단하다. Xmd / PrintP.h 에서 XmNcancelCallback 역 호출에 대하여 
XtCallbackList 를 추가한다. 

Xmd / Print.c 에서 XmdPrint 창문부품콜라스용 자원목록에 XmNcancelCallback 
역 호출을 추가한다. 

창문부품을 관리하지 않을 때는 이 역호출을 능동으로 해야 하며 do _ help _ cb () 함 
수에서 그리고 unmanage _ cb () 함수에 있는 print 역호출을 능동으로 하지 말아야 한다. 

② Print 대화칸의 통합 

그러면 Print 대화칸이 적당한 accept 와 reject 역호출을 가지므로 QMo 吐 fDialog 을 
사용할수 있 다. 우선 todo.cpp 에 QMotifDialog 머 리 부를 포함해 야 한다. 

인쇄대화칸을 창조하고 실행하는 ShowPrintDialogO 함수를 추가한다. 

Print 차림표항목을 역호출로 변경하여 새로운 ShowPrintDialogO 함수를 호출한 
다. 대화칸의 부모로 사용하는 제 일 웃준위 QMotifWidget 를 넘긴다. 

ShowPrintDialogO 함수는 Print 대화칸을 창조하고 실행한다. 

XmdNprintCallback 역호출을 사용하여 대화칸을 받아들이고 XmNcancelCallback 역 
호출을 사용하여 대 화칸을 거부한다. QMotifDialog : : acceptCallback () 와 
QMotifDialog: : rejectCallbackO 함수를 각각 사용하여 이것을 간단히 수행 할수 있다. 
또한 print 역호출을 계속하여 이전처럼 PrintO 함수를 호출한다는것을 담보한다. 

프로젝트를 구축한 후에 응용프로그람은 기대한대로 실행되고 동작한다. Print 대화 
칸이 QMotifDialog 를 리용하고있지만 시각적 이거 나 동작의 차이는 없다. 

6) Qt 기본창문클라스의 리용 

대 화칸을 모두 교체한 다음 기 본창문을 바물 준비 가 되 였 다. 우에 서 언급한것 처 럼 
현존 XmMainWindow 과 올리 펼 침 차림 표계 층을 Qt 기 본창문콜라스로 교체 한다. 

Qt Designer 로 새 기 본창문을 설계 한다. 

鐘) 기본창문의 실현 

기본창문에 대한 서술은 main window , ui 로서 보관된다. 프로젝트파일에 이 파일 
을 추가하고 Makefile 을 다시 생성한다. uic 편의프로그람은 기본창문의 코드를 생성한 
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다음 콤파일하여 응용프로그람에 련결된다. 

또한 Qt Designer 는 mainwindow . ui . h 파일을 창조한다. 기본창문실현을 골격실 
현에 추가해 야 한다. 

QApplication 와 QMotifWidget 에 필요한 머 리부들을 추가하는것으로 시 작한다. 
Motif 역 호출 struct 들과 XmdPrint 창문부품용 머 리부를 포함한다. 

이제는 기본창문안의 처리부들의 실현을 추가할 준비가 되였다. 차림표항목마다 하 
나의 처 리부를 가진다. 매개 처 리부는 todo . cpp 와 actions , cpp 에서 발견한 현존역호출 


을 호출한다. 

표 4-8. _차림표항목과 역호출 


File 차림 표 | 

New 

MainWindow :: fileNewO 

NewO 역호출을 호출한다. 

Open 

MainWindow :: fileOpenO 

Open 0역호출을 호출한다. 

Save 

MainWindow ： : fileSaveO 

SaveltO 역호출을 호출한다. 

Save As 

MainWindow : : fileSaveAsO 

SaveO 역호출을 호출한다. 

Print 

MainWindow： : filePrintO 

ShowPrintDialogO 역호출을 호출 
한다. 

Exit 

MainWindow ： : fileExitO 

QApplication : : quit 0 을 호출한 
다. 

Selected 차림표 

Properties 

MainWindow :: selProperties () 

EditPageO 역호출을 호출한다. 

New 

MainWindow :: selNewPageO 

NewPageO 역호출을 호출한다. 

Delete to 
Trash 

MainWindow :: selDeletePageO 

DeletePageO 역호출을 호출한다. 


역 호출을 사용하기전에 앞방향선언들을 추가한다. 

현존역호출함수의 매개는 3개 인수를 가진다. 이 실례에서는 모든 인수에 NULL 
을넘긴다. 현존코드는 어떤 인수에도 의존하지 않는다. 매개의 처리부실현은 관련된 역 
호출함수를 호출하는 단일행 이 다. 코드는 그리 흥미없고 공간을 소비하므로 생 략한다. 

4가지 례외가 있다. Open () , SaveO , EditPageO 그리고 DeletePageO 역호출 
은 인수 2( client _ data 인수)로서 제일웃준위 QWidget 의 지적자를 넘긴다. 이 4개 함수 
들에서 둘째인수로서 QMainWindow 에서 파생된 제일 웃준위 MainWindow 인 比 iis 를 
넘긴 다. 

② 기본창문의 교체 

다음 단계는 응용프로그람에서 새로운 기본창문을 사용하는것이다. todo . cpp 에서 
필요한 변경은 대량의 코드를 삭제하였으므로 크다. 

우선 새로운 기본창문용의 머 리부를 추가한다. 

Motif 머 리 부의 대 부분이 더 는 필요없으므로 삭제한다. 

QuitApplO 과 manageCBO 역호출은 더는 필요하지 않으므로 그것들을 삭제한다. 
대역 shell 변수도 필요없다. New () , SaveO and Open 0 역 호출에서 그것과 그 모든 
참고를 삭제 한다. 

mainO 을 많이 변경 한다. 우선 XmMainWindow 을 가지는 QMotifWidget 대신에 
새 로운 MainWindow 을 사용한다. 

이제는 QMotifWidget 을 사용하여 XmNotebook 창문부품을 창조한다. 

Motif 차림표를 창조하는데 사용한 모든 코드를 삭제한다. mainO 의 나머지 코드는 
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자체로 해석하시오. 

이제는 응용프로그람이 XmMainWindow 대신에 QMainWindow 을 사용한다. 프로 
젝트를 구축한 다음 응용프로그람은 기대한대로 실행되고 동작한다. 

7) 현존코드의 재분해 

다음에 서술한 단계들은 이식과정에 필요없지만 완전성에 필요하다. 

逆) 자료구조를 C ++ 에 이식 

Page 자료구조는 불투명한 자료형이다. 실제자료구조는 PageRec 라고 부르며 Page 
는 PageRec 의 지적자로 정의된다. 또한 PageRec 구조체에 기억기를 할당하고 초기화 
하는 AllocPageO 함수를 가지고있다. 

C ++ 에서는 구성자에서 이것을 수행한다. 또한 PageRec 에서 모든 자원을 자동적으 
로 해 방하는 구성 자를 쓸수 있다. 

PageRec 구조체선언은 page , h 에서 삭제된다. PageRec 와 같은 자료성원，구성자 
와 해체 자를 가지는 Page 구조체를 선언한다. 

현존 pages , currentPage 그리고 maxpages 대역변수들은 원천파일들로부터 삭제 
된다. page , h 에서 그것들을 extern 선언으로 교체 한다. 

대역변수실례화는 todo . cpp 에 선언된다. 

매개 원천파일은 Page 관련 대역변수들을 취급하는 함수선언들을 포함한다. 원천파 
일들로부터 이 선언들을 삭제하고 그것들을 page.h 머 리부파일에서 선언한다. 

Page 가 구성자를 가지므로 AllocPageO 함수를 삭제한다. 그것은 더는 필요없다. 
AllocPageO 에 대한 호출은 NewPageO , DeletePageO 그리고 ReadDBO 함수들에 
서 new Page () 로 교체된다. 또한 delete pages [치를 가지고 폐지들을 해체 하도록 
코드를 교체한다. 여기서 표는 적당한 색인값이다. 이것은 ReadDB 와 DeletePageO 함 
수들에 서 수행된다. 

대역변수 pages 를 호출하는 코드는 Page 구조체의 자료성원들이 변경되지 않았으므 
로 수정할 필요가 없다. 현존코드는 계속 동작한다. 

page.h 에서 선언한 OptionsRec 구조체도 갱신되며 우의 Page 구조체와 같은 견본 
을 따른다. 

또한 todo . cpp 에 대역변수실례화도 있다. 

대역변수 options 를 호출하는 코드는 Options 구조체의 자료성원들을 변경하지 않 
았으므로 수정하지 않는다. 현존코드는 계속 동작한다. 

逐) new 와 delete 의 사용 

Page 와 Options 구조체들의 해체자들은 X 切 ' reeO 대신에 delete 를 사용하여 모든 
char * 성원들을 해체 한다. 이것은 Xt / Motif 로부터 이식 하고있으므로 필요한 변경 이다. 
Page 구조체 성원들을 new 와 delete ( XtMalloc 0, XtNewStringO 그리고 XtFreeO 
대신에)를 사용하도록 수정하는 현존코드를 고착시켜야 한다. 

todo . cpp 에서 PageChangeO 함수는 단지 SetPageO 를 호출하기 전에 현재 폐지 
의 내용과 유표위치를 보관한다. Page 구조체의 성원들을 수정할 때 new 와 delete 를 
사용한다. 

XmText 창문부품의 내 용을 보관할 때 qstrdupO 를 리용하여 

XmTextGetS 比 ing () 함수로부터 돌아온 문자렬의 사본을 만든다. 

io.cpp 에서 ReadDBO 함수는 류사한 변경을 요구한다. XtMallocO 와 

XtNewStringO 의 모든 사용을 new 와 qstrdupO 로 각각 교체한다. 

이것은 바로 파일을 열기전에 새 폐지를 시작할 때와 타브본문에서 읽어들일 때 수 
행 해 야 한다. 

ReadDBO 함수는 XtReallocO 를 리용하여 자료기억완충기를 전개한다. 불행하게 
도 C ++ 는 현존자료블로크를 재 할당하는 방법을 제공하지 않으므로 자체로 수행 한다. 
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또한 ReadDBO 에서 2의 인수로 XtMallocO 를 호출하는 경우가 한번 있다. 이것 
은 파일을 읽을수 없을 때 수행된다. 빈문자렬창조는 필요없으므로 이 코드를 삭제하고 
그대 신 new 를 사용한다. 

io.cpp 에서 SaveDBO 함수도 역시 이 변경을 요구한다. XtFreeO 의 한번의 출현 
을 delete 로 변경한다. 

끝으로 todo.cpp 의 mainO 함수에서 XtNewString 0의 두번의 출현을 교체한다. 

③ 현존코드의 이동 

재분배과정의 나머지는 현존코드를 새 위치로 이동하는것을 포함한다. 현재 
mainwindow . ui.h 파일의 각 함수는 단지 다른 파일들에 있는 낡은 역호출처리함수들 
을 호출한다. 낡은 역호출함수들을 호출할 대신에 실현이 그에 따라 이동된다. 


표 4-9. _ 이동하는 함수들 


함수 

원시 파일 

이동하는 함수 

New () 

todo . cpp 

MainWindow : : fileNewO 

OpenO 

todo . cpp 

MainWindow : : fileOpenO 

SaveltO 

actions , cpp 

MainWindow :: fileSaveO 

SaveO 

todo . cpp 

MainWindow ： : fileSaveAsO 

ShowPrintDialogO 

todo . cpp 

MainWindow :: filePrintO 

EditPage () 

actions , cpp 

MainWindow ： : selProperties 0 

NewPageO 

actions , cpp 

MainWindow :: selNewPageO 

DeletePageO 

actions , cpp 

MainWindow :: selDeletePageO 


PrintO 역호출함수는 여전히 Print 대화칸으로 교체되므로 그것을 

main window , ui . h 5_ 이동하고 static 로 만든다. 

이전에 OpenO , SaveO , EditPage () 그리고 DeletePageO 함수들은 부모인수로 
서 client_data 를 가지고 대화칸을 창조하였다. 코드를 직접 기본창문실현으로 이동하였 
으므로 부모인수로서 this 를 리용하여 이 대화칸들을 창조한다. 

PageChangeO 역호출함수는 actions.cpp 로부터 todo.cpp 로 옮기고 어디서나 사 
용하지 않으므로 static 로 만들었다. 

actions.cpp 에 대한 초기의 실현은 Trim 0함수가 여분으로 만들었으므로 그것을 
삭제 한다. 

todo.cpp 에서 MIN 0 과 MAX 0 마크로는 여분으로 된다. Qt 는 우리가 사용할 
QMINO 와 QMAX 0 마크로들을 제공한다. 

초기의 수정이 fallback_resources 배럴을 여분으로 만들었으므로 삭제한다. 

가까운 미래에 우리의 프로그람은 Motif 를 더는 사용하지 않을것이며 더는 QMotif 
를 사용하지 않게 될것이다. 이것을 준비하기 위하여 resources 과 optionDesc 배렬을 
삭제 하고 APP_CLASS 인수를 가지는 QMotif 실례를 창조한다. 

원천파일들에서 Mnclude 문들은 재분배변경으로 인하여 대체로 부정확하다. 대부 
분의 #include 문들은 더는 필요하지 않다. 매개 파일로부터 壯 nclude 문들은 아래에 
렬거 하며 어 느 머 리 부가 매 개 파일 에 삭제 되 고 추가되 는가 서 술하지 않는다. 
actions , cpp 용 머 리부 
io.cpp 용 머리부 
todo . cpp 용 머 리 부 
main window , ui . h 용 머리 부 
8) 보기창문부품의 교체 
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View 창문부품을 교체할 준비가 되였다. 하지만 실례프로그람은 XmNotebook 창문 
부품콜라스를 사용한다. Qt 는 이 콜라스와 등가한것을 직접 제공하지 않으며 3가지 가 
능성이 있으며 매개는 우결함을 가전다. 

① 현존 Qt 창문부품들을 사용하여 변환을 계속할수 있다. 

우점 - Qt 가 제공하는 창문부품들은 잘 설계되고 시험되였으며 사용자대면부를 고 
속으로 재설계할수 있다. 

결함 - 대체로 현존자료구조와 코드를 수정하거나 다시 써야 한다. 새 코드는 응 
용프로그람의 이전판과의 호환성을 유지하는 방법으로 써 야 한다. 

逐) XmNotebook 창문부품클라스와 등가한 QWkiget 의 새 로운 파생콜라스를 쓸수 있다. 

우점 - 현존자료구조는 변경하지 않으며 이전과 앞으로의 판들과 호환성을 가지게 한다. 

결함 - 새 창문부품을 쓰고 다시 시험해야 한다. 응용프로그람에서 현존코드는 새 
토운 창문부품의 API 를 취급할수 있도록 변경되여야 한다. 

m XmNotebook 창문부품에 손을 대지 않게 할수 있다. 

우점 - 현존자료구조와 코드는 변경되지 않으므로 다른 프로젝트들에 대하여 개발 
을 계속할수 있다. 

결함 - 이것은 가장 단순한 해결이지만 응용프로그람은 여전히 XII 에 의존하며 
Qt 가 유지 하는 모든 가동환경 에 서 응용프로그람을 전개시 킬수 없 다. 

첫째 수법 으로 실례 프로젝 트의 이 식을 완성하며 QTextEdit , QLabel 그리 고 
QSpinBox 를 리용하여 류사한 형식을 제공한다. 유일한 차이는 타브를 가지고있지 않 
는것 이 다. 

Qt Designer 를 리 용하여 QTextEdit , QLabel 및 QSpinBox 창문부품을 기 본창문 
창문부품에 추가한다. 

Q ) 자료구조수정 

Page 구조체 는 삭제 해 야 할 majorPB 와 minorPB 성 원들을 가지 고있 다.이 성 원들은 
현존판에서 현시된 타브들에 대응된다. 새 판은 타브를 가지지 않으므로 삭제한다. 

② 코드수정 

응용프로그람에 서 현존함수들의 대 부분은 새 View 창문부품과 작업 하도록 수정 되 


여야 한다. MainWindow 콜라스는 현존함수들에 대응하는 5개의 새 함수를 가진다. 
표 4-10. _ 현존함수와 새 함수들 _ 


현존 함수 

새 함수 

void SetPage( int ) 

void MainWindow ： : setPage( int ) 

void PageChange( … ) 

void MainWnidow： : pageChange( int ) 

void TextChanged( ... ) 

void MainWnidow： : textChangedO 

void ReadDB( char * ) 

void MainWindow :: readDB ( char * ) 

void SaveDB( char * ) 

void MainWindow :: saveDB ( char * ) 


SetPageO 함수실현은 mainwindow . ui . h 에서 MainWindow : : setPage () 함수로 
옳긴다. page . h 와 actions . cpp 에서 각각 SetPageO 함수선언과 실현을 삭제한다. 
MainWindow： : setPageO 가 정 확히 동작하게 하기 위 하여 기 본창문창문부품에서 새 
창문부품을 사용하도록 코드를 수정한다. 

우선 spinbox 의 현재값을 현재폐지번호로 설정한다. 

다음에 textedit 의 현재 본문과 유표위 치 를 현재 페 지 의 내 용으로 설 정 한다. 

현재 페지가 사용자정의표식자를 가지면 그것을 textlabel 의 현재본문으로 설정하 
고 그렇지 않으면 textlabel 내 용을 "Page X "(여 기서 표는 현재폐 지 번호)로 설정한다. 
현재폐지가 크고작은 타브본문을 가지면 이것들을 labeltext 에 추가한다. 이것은 
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사용자가 입력한 모든 정보가 보인다는것을 담보한다. 

현재 페지가 존재하지 않을 가능성을 계속 조종해야 한다. 이 경우에 textedit 창문 
부품의 내용을 삭제하고 textlabel 내용을 현재폐지번호(폐지가 무효라는 지적을 가진 
다)로 설정한다. 

PageChangeO 함수는 todo.cpp 으로부터 main window , ui . h 의 MainWindow :: 
pageChangeO 함수로 옳긴다. MainWindow : : setPae () 함수에서처럼 코드가 기본창문 
창문부품의 새 창문부품들을 사용하도록 수정해 야 한다. 

알아두기: QTextEdit :: text () 는 표준 char * 배럴로 변환할것을 요구하는 QString 
을 돌려준다. 그러자면 국부부호화에서 문자렬의 사본을 창조한다. 
QString : : local 8 Bit () 에 의하여 돌아온 QCString 에 포함된 자료가 QCString 이 해체 
될 때 해체되므로 qstrdupO 을 리용하여 사본을 만들 필요가 있다. 

TextChangedO 함수는 modified 변수를 1로 설정하는것외에 다른것을 하지 않는 
다. 새 MainWindow : : textChanged () 함수는 정 확히 같은 일을 한다. 

MainWindow :: pageChange 0 와 MainWindow :: textChanged 0 함수들 이 대 역 
변수 modified 를 호출하므로 main window , ui . h 의 선두에 앞방향선언을 추가한다. 

io . cpp 에 서 ReadDB 0 와 SaveDB 0 실 현은 각각 MainWindow :: readDB 0 과 
MainWindow : : saveDB () 으로 이 름을 변경 한다. 코드가 적 당히 작업 하도록 수정 하여 야 
한다. 

우선 MainWindow , QSpinBox 및 QTextEdit 둘라스의 #include 문을 추가한다. 

새 로운 MainWindow :: readDB 0와 MainWindow : : saveDB 0 함수들은 Xt/Motif 
함수를 사용하지 않으므로 Xt/Motif #include 문과 대 역변수 notebook 와 textw 를 삭 
제 한다. 이 함수들은 크게 변경 되 지 않고 이 전판들과 호환을 유지한다. 또한 ReadDB () 
과 SaveDB () 함수들은 MainWindow 성원함수들로 변환되였으므로 this 를 parent 인 
수로서 QMessageBox 함수들에 넘길수 있다. 

MainWindow :: readDB 0함수에서 파일을 읽어들인 후에 spinbox 의 현재값과 최 
대값들을 적당히 설정한다. 

MainWindow : : saveDB 0 함수에서 현재 현시된 본문을 보관하므로 

QTextEdit :: text 0 를 XmTextGetString 0 대 신에 리 용한다. 

알아두기: QTexffidit :: text () 은 표준 char * 배렬로 변환할것을 요구하는 QString 
을 돌려준다. 그러자면 국부부호화에서 문자렬의 사본을 창조한다. 
QString : : local 8 Bit () 에 의하여 돌아온 QCString 에 포함된 자료가 QCString 이 해체 
될 때 해체되므로 qstrdupO 을 리용하여 사본을 만들 필요가 있다. 

Page 구조체로부터 majorPB 와 minorPB 성원들의 삭제로 인하여 actions.cpp 에서 
FixPagesO 함수는 더는 필요없다. actions , cpp 와 page , h 로부터 FixPagesO 의 실현 
과 앞방향선언을 삭제 한다. FixPagesO 호출은 MainWindow : : selNewPage () 와 
MainWindow : : selDeletePage () 로부터 삭제되고 그것들은 둘다 main window , ui . h 
에 있다. 

AdjustPages 0 를 main window , ui . h 로 옮기고 이 파일에서 만 리 용하므로 static 
로 만든다. page.h 로부터 앞방향선언을 삭제한다. 

수정 후에 actions , cpp 파일은 빈다. 프로젝트파일에서 그것을 삭제하고 Makefile 
을 다시 만든다. 

새 로운 View 창문부품을 실현하였 으므로 낡은 Motif 기 초보기 창문부품을 todo.cpp 
에서 삭제하여 야 한다. 

Motif 창문부품을 하나도 사용하지 않으므로 qmotifwidget . h 를 포함하는 모든 
Motif #include 문을 삭제 한다. 

또한 ReadDBO 함수의 앞방향선언과 notebook , textw 및 labelw 대역변수들을 


147 



삭제 한다. 

다음에 QMotifWidget 를 사용하는 center 창문부품을 삭제한다. 기본창문창문부품 
과 View 창문부품을 Main Window 클라스에서 완전히 포함하므로 여분의 초기화는 
main window 창문부품창조후에 요구된다. 

ReadDBO 와 SetPageO 함수들이 Main Window 성원함수들로 변경되였으므로 
mainwindow 실례를 리 용하여 그것들을 호출해 야 한다. 

View 창문부품은 현재 교체되였다. 프로젝트를 구축하고 응용프로그람이 정확히 동 
작하는가 확인한다. 

9) 인쇄대화칸의 교체 

Print 대 화칸은 응용프로그람에서 Motif 를 사용하는 마지 막 부분품이다. 현재 
Print 0함수는 일시파일에 평본문을 쓰는것외에 아무것도 하지 않고 ’ lpr ’ 을 실행하여 
본문을 인쇄기에 보낸다. QPrinter 를 사용하므로 이 함수가 아무것도 하지 않으므로 삭 
제 한다. 현재 MainWindow : : filePrint () 실현은 삭제된다. 새 로운 

MainWindow : : filePrint () 실현을 mainwindow . ui . h 에 쓴다. 

3) 인쇄에 리치본문의 리용 

어는 HTML 의 부분모임 을 사용하는 리치 본문을 제 공한다. QSimpleRichText 클 
라스는 리치본문인쇄를 간단하게 만든다. 우리가 해야 할 일은 적당한 위치에 삽입된 적 
당한 형 식타그들을 창조하는것 이 다. 실례 에서 인쇄 출력 을 이전판들과 비슷하게 유지한다. 

우선 사용할 형 식타그들을 창조한다. 

다음에 모든 폐지들을 순환하면서 폐지표식자，내용 및 형식문자들을 printtext 변 
수 ( QString ) 에 주가한다. 

MainWindow : : filePrint () 함수의 나머지는 실제의 인쇄코드이 다. 여기서 간단히 
우에서 창조한 문자렬을 리 용하는 QSimpleRichText 객체를 창조하고 이 문자렬을 
QPainter 를 리용하여 QPrinter 객체에 그린다. 

② Xt / Motif 에서 의존관계의 삭제 

응용프로그람은 Xt 나 Motif 창문부품들을 더는 사용하지 않는다. 이제는 Xt 와 
Motif 에 대한 의존관계삭제를 완료할수 있다. 

우선 ^include 문들을 mainwindow . ui . h 에서 삭제 한다. 

MainWindow : : fileNew () 함수는 Xt 서 고로부터 Boolean 과 False 예 약어 들을 사 
용한다. C ++ 는 이것들을 언어에 구축하였으므로 bool 과 false 를 대신에 사용한다. 

응용프로그람에서 Xt 와 Motif 를 완전히 삭제하는데 필요한 마지 막 수정 은 QMotif 
콜라스의 리 용을 중지 하는것이다. todo . cpp 에서 qmotif . h # include 문을 삭제하고 
main 0함수에서 실례화를 삭제한다. 

이 렇게 한 다음 프로젝트파일의 LIBS 변수에서 - lXm 와 - lqmotif 를 삭제 할수 있다. 
프로젝트파일은 또한 응용프로그람에서 이전에 사용한 낡은 사용자정의 Motif 창문부품 
들을 위 한 원천과 머 리부들이 포함되 여 있 다. 이 것 들도 삭제 한다. 

Makefile 을 다시 만들고 프로젝트를 구축한 다음 응용프로그람이 정확히 동작하는 
가 확인한다. 

10) 개발의 계속 

프로젝트에서 Motif 를 더는 사용하지 않아도 Qt 에로의 이식이 완전히 끝난것은 아 
니다. Qt 는 즉시 리용할수 있는 수많은 유용한 특성 을 제 공한다. 가장 흥미있는것들중 
의 일부는 현존프로젝트의 확장을 시작하기 위한 차림표로서 아래에 제시한다. 

建) 유니코드리용 

국제화지원은 어에서 아주 쉽다. 본문보관에서 char * 대신에 QString 의 리용은 세 
계의 대부분의 언어들에 대한 지원을 준다. Page 와 Options 구조체는 현재 더 간단해보 
인다. 
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Page 와 Options 구조체를 사용하는 모든 함수들은 QString 을 적당히 사용하도록 
갱신되여야 한다. 또한 QString 은 암시적공유들라스이므로 문자렬들과 관련한 기억관 
리 를 더 는 하지 말아야 한다. qstrdupO 함수의 출현을 모두 삭제 하고 문자렬 과 작업 할 
때 더는 new 나 delete 를 사용하지 말아야 한다. QString 은 필요할 때 자료를 할당하 
고 삭제한다. 

여 기 에 main window , ui . h 로부터 발취 한 MainWindow :: fileOpenO 과 
MainWindow :: pageChangeO 함수가 있다. 본문을 보관할 때 코드에서 delete 혹은 
qstrdupO 를 더는 사용하지 않는다. 

응용프로그람에서 함수들의 거의 대부분은 이 변경의 영향을 받는다. 대부분의 경 
우에 우리 가 추가하는것보다 더 많은 코드의 삭제 로 끝난다. 

② 가동환경에 의존하지 않는 코드쓰기 

어는 수많은 입출력들라스들을 제공한다. MainWindow :: readDB () 와 
MainWindow : : saveDB () 에서 이 것들을 사용한다. 현재 이 함수들은 UNIX 를퓨터 들에 
서 발견한 함수들만 사용한다. QFile 과 QTextStream 사용은 UNIX 에 대한 의존을 없 
애며 Microsoft Windows 와 Apple Mac OS 표에서 응용프로그람을 구축하고 시험할 
수 있 다. 

가동환경에 의존하지 않는 판의 MainWindow :: readDB () 와 
MainWindow :: saveDBO 함수들은 io . cpp 파일 에 있 다. 

運) 현대사용자대면부의 설계 

Qt Designer 로 기본창문창문부품을 설계하였으므로 대면부를 간단히 확장할수 있 
다. 류동가능도구띠를 포함하는 QMainWindow 의 고급한 특성들을 리용할수 있다. 이 
것은 Qt Designer 로 간단히 추가할수 있다. 프로젝트의 최종판은 Open , Save , 
Print , New Page 그리고 Delete to Trash 작용들의 고속호출을 제공하는 도구띠를 
포함한다. 

가능성은 끝이 없다. 공통의 Cut , Copy 및 Paste 작용을 가지는 Edit 차림표가 상 
대적으로 짧은 시간동안에 추가될수 있다. 우리의 프로젝트는 다른 가동환경으로 확장되 
며 보통탁상를퓨터와 Qt/Embedded 를 가지고 실행하는 수첩형장치사이에 todo 목록을 
동기화하게 하는 차림표와 대화칸들을 추가할수 있다. 


제 12절. Qt OpenGL 확장에서 XI I 오버레이를 사용하는 방법 

XII 오버 레 이 ( overlay ) 는 화상을 파괴 함이 없이 화상우에 주해 를 그리 기 위 한 강 
력 한 기 구로서 대 량의 화상묘사시 간을 절 약한다 [1]. 

경 고: 5.0 판으로부터 Qt OpenGL 확장은 OpenGL 오버레이 들의 사용을 위한 직 접 
적 인 지 원을 포함한다. 오버레이의 수많은 사용에서 이것은 아래 에 서술하는 기술이 여 
유를 가지게 한다(오버레이실례프로그람 참고). 다음은 오버레이평면들에서 비 QGL 창문 
부품들을 사용하는 방법 에 대 하여 설 명한다. 

전형 적 인 경 우에 XII 오버레이 들은 현재 판의 Qt 와 Qt OpenGL 확장과 함께 간단히 
사용될수 있다. 다음의 요구를 적용한다. 

① 자기의 X 봉사기와 그라픽스카드/하드웨 어 는 오버레이를 지 원해 야 한다. 수많은 
X 봉사기들에서 오버레이지원은 환경구성선택에 의해 설정될수 있다(자기의 X 봉사기설 
치문서 참고). 

② 자기의 X 봉사기 는 오버레 이시 각 ( visual ) 을 기정 시각으로 사용하도록 환경 이 구 
성되 여 야 한다. 대 다수 현대 x 봉사기들은 이것 을 수행하므로 올리펼침차림 표，겹 침창문 
등 추가적인 우점을 가지며 기본평면에서 기초화상들을 파피하지 않으므로 품이 드는 재 
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그리기를 피한다. 

③ OpenGL 묘사를 위한 가장 좋은(가장 깊은) 시각은 기본평면에 있다. 이것은 보 
통의 경우이 다. 전형적으로 오버레이를 유지 하는 X봉사기들은 기본평면에서 24bit 깊이 
TrueColor 시 각을 제 공하고 오버 레 이 평 면 에 서 8 bit Pseudocolor (기 정 ) 시 각을 제 공한 
다. 제공된 실례 프로그람 XII오버레 이는 이것들을 검사하고 오유를 알린다. 

1. 작업방법 

우에 주어 진것 처 럼 QGLWidget 는 기정 으로 기본평면시각을 리용하는 한편 다른 모 
든 창문부품들은 오버레 이시각을 리용한다. 이 리하여 QGLWidget 의 곡대기우에 표준창 
문부품을 배 치 하고 OpenGL 창문안의 화상을 파괴 하지 않고 표준창문부품우에 그리기 할 
수 있 다. 다시 말하면 QPainter 의 그리기 능력을 모두 발휘 하여 주해, 선택 창 
(rubberband) 등을 그릴수 있다. 이것은 오버 레이의 전형적 인 사용으로서 주해를 그리 
는데 OpenGL 을 사용하기 보다 훨씬 더 쉽 다. 

오버 레 이평면은 투명색 이라는 고유한 색을 가진다. 이 색 으로 그린 화소들은 보이 
지 않으며 대신에 기초에 놓여있는 OpenGL 화상은 들여다보인다. 실례프로그람 XII오 
버레이에서 파일 main.cpp 은 투명색을 포함하는 QColor 을 돌려주는 루린을 포함한다. 
오버레 이 창문부품에 서 는 일 반적 으로 배 경 색 을 투명 색 으로 설 정 하려 고 하므로 OpenGL 
화상은 그것 이 명 백 히 겹 쳐 그려 지 는 경 우를 제 외 하고 들여 다보인 다. 

알아두기: 이 기술을 사용하려면 QApplication 에 "ManyColor” 혹은 
"TrueColor" ColorSpec 를 사용하지 말아야 한다. 왜냐하면 필요할 때 오버레이평면 
이 아니라 보통 기본평면에 있는 표준 Qt 창문부품들이 TrueColor 시각을 사용하기때문 
이 다. 


2. XII시각에 대하여 

utilities 등록부에는 자기 X봉사기의 능력을 결정할수 있도록 방조할수 있는 두개의 
작은 프로그람들이 포함되 여있다. 

glxvisuals 는 X봉사기가 제공하는 모든 GL 능력이 있는 시각들을 매개에 대한 깊 
이와 기타 GL 고유정보와 함께 렬거한다. 특히 "lvl” 란을 지적한다. 이 란안의 수자는 
시각이 오버 레 이평면내 에 있다는것을 의미 한다. 

sovinfo 는 쓸수 있는 모든 시각들을 렬거하며 오버레이시각들의 특별한 투명정보를 
제공한다. 

XII오버레이실례프로그람은 표준 Qt 창문부품들에 어떤 시각이 사용되는가와 

QGL Widget 에 의해어떤 시각이 사용되는가를 출력한다. 


제13절. 응용프로그람그림기호의 설정 

일반적으로 응용프로그람의 왼쪽웃구석에 표시되는 응용프로그람그림기호는 제일 
웃준위 창문부품에 대 하여 QWidget: :setIcon() 호출에 의 하여 설정된다. 

실 행 가능응용프로그람파일 자체 의 그림기 호를 변경 하기 위 하여 서 는 탁상에 그것 이 표시 
될 때 (즉 응용프로그람의 실행에 앞서) 가동환경에 의존하는 기술을 받아들여 야 한다. 

1. Windows 에서 응용프로그람그림기호의 설정 

우선 그림 기 호화상을 포함하는 ICO 형 식비 트매 프파일을 창조한다. 이것은 
Microsoft Visual C++ 에서 File|New ... 를 선택하고 그때 나타나는 대화칸의 File 타브 
를 선택하고 Icon 을 누르는 방법 으로 수행할수 있다. (자기의 응용프로그람을 Visual 
C++ 에 적재할 필요는 없으며 오직 그림기호편집기만 리용한다.) 

자기 응용프로그람의 원천코드등록부에 ICO 파일 례를 들면 myappico.ico 라는 이 
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틈으로 보관한다. 그다음 다음과 같이 한행의 본문을 넣은 본문파일 실례로 myapp.rc 
를 작성한다. 

IDIJCONIICON DISCARDABLE " myappico . ico " 

끝으로 makefile 생성에 qmake 를 사용하는것을 전제로 하여 다음의 행을 자기의 
myapp.pro 파일에 추가한다. 

RC_FILE = myapp . rc 

makefile 과 응용프로그람을 다시 생성한다. 이제는 .exe 파일이 Explorer 에서 그 
림기호로 표시된다. 

qmake 를 사용하지 않을 때 필요한 단계들은 우선 .rc 파일에서 rc 프로그람을 실행 
하고 응용프로그람을 생성된 .res 파일과 련결한다. 

2. Mac OS 표에서 응용프로그람그림기호의 설정 

일 반적 으로 응용프로그람의 류동 ( dock ) 령 역 에 표시 되 는 응용프로그람그림 기 호는 
제일 웃준위의 창문부품에서 QWidget :: setIcon () 호출에 의하여 설정된다. 이것은 프로 
그람이 함수호출전에 응용프로그람의 류동령 역에 표시할수 있게 하며 이 경우에 기정 그 
림기호는 동화상이 동작할 때 나타난다. 

정 확한 그림기 호이 나타난다는것 을 담보하기 위 하여 응용프로그람이 기동되 고있을 
때와 Finder 에서 가동환경에 의존하는 기술을 받아들이는것 이 필요하다. 

대 부분의 프로그람들이 그림 기 호파일 (. icns ) 을 창조할수 있지 만 권고하는 수법 은 
Apple 에 의하여 제공되는 Icon Composer 프로그람 ( Developer/Application 흘더에서) 
을 리용하는것 이 다. Icon Composer ^： 몇가지 각이한 크기의 그림기호를 반입하는것은 
물론 각이한 상황에서 리용할수 있게 한다. 프로젝트등록부에 그림기호들의 모임을 하나 
의 파일로 보관한다. 

makefile 생성에 qmake 를 사용한다면 .pro 프로젝트파일에 다음의 한행을 추가해야 
한다. 실례로 그림기호파일의 이름이 myapp.icns 이고 프로젝트파일이 myapp.pro 이면 
다음 행을 myapp . pro 에 추가한다. 

RC_FILE = myapp . icns 

이것은 qmake 가 적당한 위치에 그림 기호들을 넣고 그림 기호를 위 한 Info.plist 항 
목을 창조한다는것을 담보한다. 

qmake 를 사용하지 않는다면 다음과 같이 수동적으로 수행한다. 

■■① Developer/Applications 에 있는 PropertyListEditor 를 사용하여 응용프로그 
람용의 Info.plist 파일을 창조한다. 

d ) 다시 PropertyListEditor 를 리 용하여 .icns 레코드를 Info.plist 파일 안의 
CFBundlelconFile 레코드와 련결한다. 

想) 자기의 응용프로그람묶음 Resource 등록부에 icns 과 Info.plist 를 모두 복사한다. 

3. 일반 Linux 탁상에서 응용프로그람그림기호의 설정 

여기서는 두가지 일반 Linux 탁상환경 KDE 와 GNOME 에서 응용프로그람의 그림기호 
를 제공하는 방법을 간단히 서술한다. 응용프로그람그림기호들을 서술하는데 사용하는 핵 
심기술은 두 탁상에서 갈으며 다른데에도 적용할수 있지만 매개에는 고유한 특성이 있다. 

흔히 사용자들은 실행가능파일을 직접 사용하지 않지만 그대신에 응용프로그람을 
탁상우의 그림기 호를 선택하여 기동한다. 이 그림 기 호들은 그 그림 기 호에 대 한 정 보를 
비롯한 응용프로그람의 서술을 포함하는 탁상항목파일들의 표시이다. 두 탁상환경은 이 
파일들의 정보를 엄을수 있으며 그것을 리용하여 탁상우에，시작차림표에 그리고 조종판 
에 응용프로그람에 대 한 지 름건를 생 성한다. 

탁상항목파일들을 응용프로그람의 세부를 효과적으로 밀봉할수 있지만 여전히 각 
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탁상환경 에 편리 한 위 치 에 그림 기 호들을 보관해 야 한다. 

비록 그림기호들을 찾는데 리용되는 경로가 사용하는 탁상과 그 환경구성，등록부 
구조에 의존하지만 그 매개는 갈은 패턴을 따라야 하며 보조등록부들은 주제 ( theme ), 
그림기호크기， 응용프로그람형에 따라서 배렬된다. 일반적으로 응용프로그람그림기호들 
은 hicolor 주제에 추가되므로 크기가 32화소인 바른4각형 응용프로그람그림 기호는 그림 
기 호경 로아래 의 hicolor /32 x 32/ apps 등록부에 보관되 군한다. 

資) KDE 

응용프로그람그림기호들은 모든 사용자들이 리용하거나 개별적인 사용자가 사용하 
기 위하여 설치할수 있다. 현재 KDE 탁상에 가입한 사용자는 kde - config 에 의하여 실 
례로 말단창문에서 다음과 같이 입력하여 그 위치를 발견할수 있다. 

kde-config —path icon 

일반적으로 sMout 에 출력된 두점으로 구분된 경로목록은 사용자에게 고유한 그림 
기 호경 로와 체 계범위의 경 로를 포함한다. 이 등록부들아래 에서 그림기 호주제사양에 서 술 
된 관례에 따라 그림기호들을 찾고 설치할수 있어 야 한다. 

KDE 전용으로 개발하고있다면 KDE 구축체계의 우점을 리용하여 응용프로그람의 환경 
을 구성해야 한다. 이것은 그림기호들이 KDE 용의 적당한 위치에 설치되도록 담보한다. 

② GNOME 

응용프로그람그림 기 호들을 구성 방식 에 의 존하지 않는 파일 들을 포함하는 표준체 계 
범위등록부안에 보관된다. 이 위치는 gnome - config 에 의해 결정할수 있으며 실례로 말 
단창문에서 다음과 같이 입력할수 있다. 

gnome-config —datadir 

stdout 에 출력된 경로는 pixmaps 라는 등록부를 포함하는 위치를 참고하고 
pixmaps 등록부안의 등록부구조는 그림 기 호주제 사양에 서 술된 다. 

GNOME 전용으로 개발한다면 GNU 구축도구의 표준일식을 사용하려고 할수 있다. 
(이것도 GTKVGnome 응용프로그람개발서적의 적절한 절에서 서술한다.) 이것은 그림 
기호들이 GNOME 용 적당한 위치에 설치되도록 담보한다. 


제14절. 쎄숀관리 


1. 정의 

쎄 손 ( session ) 은 각각 특정 한 상태 를 가지 는 실 행 중에 있는 응용프로그람들의 그롭이 
다. 쎄숀은 쎄 손관리기 라는 기 구에 의해 조종된 다. 쎄숀에 참가하는 응용프로그람들을 
쎄 손의 뢰 기 라고 부론다. 

쎄숀관리기는 의뢰기에 사용자를 위한 지령을 내보낸다. 이 지령들은 의뢰기들이 
보관하지 않은 변경 의 보관(실례 로 열린 파일들을 보관하여 )을 맡기거 나 앞으로의 쎄 손 
들을 위하여 그것 들의 상태 를 보존하거 나 단순히 완료한다. 이 조작들의 모임 을 쎄 손관 
리 라고 한다. 

일 반적 인 경 우에 쎄손은 사용자가 탁상에 서 한번에 실 행하는 모든 응용프로그람들 
로 이루어진다. 그러나 Unix / Xll 하에서 쎄손은 각이한 콤퓨터들에서 실행하고있는 응 
용프로그람들을 포함할수 있으며 여러개의 현시기를 사용할수 있다. 

2. 쎄숀의 완료 

쎄손은 보통 사용자가 탈퇴하려고 할 때 쎄손관리기에 의해 완료된다. 또한 체계는 
비상상태에서 실례로 전원이 꺼진 경우에 자동중지를 수행할수 있다. 틀림없이 이런 형 
의 중지들사이에 중요한 차이가 있다. 처음에 사용자는 응용프로그람과 교제하여 어느 
파일들을 보관하고 어느 파일들을 무시하겠는가를 명백히 지정할수 있다. 파일들을 무시 
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하는 경우에는 교제할 필요가 없다. 름퓨터앞에 앉아있는 사용자가 한명도 없을수 있다. 


3. 통신규약과 각이한 가동환경에 대한 지원 

Mac OS 표와 MS-Windows 에는 아직 응용프로그람들을 위한 완전한 쎄숀관리가 
아직 없으며 이전 쎄숀들의 복귀도 없다. 이 조작체계들은 응용프로그람들이 사용자로부 
터 확인을 받은 후에 프로쎄스를 취소할 기회를 가지는 단순한 탈퇴 ( logout ) 를 지원한 
다. 이것은 QApplica 吐 on : : commi 1 :DataO 메쏘드에 대 응하는 기능이 다. 

XII 은 X 11 R 6 부터 완전한 쎄숀관리를 유지 하였다. 

4. Qt 에 의한 쎄손관리 

QApplication : : commitData () 를 재정의 함으로써 자기 응용프로그람이 고상한 랄 
퇴처리를 하게 하는것으로 시작하자. 오직 MS-Windows 가동환경만 목표하고있다면 이 
것은 가능한껏 제공되여야 한다. 실제로 자기의 응용프로그람은 다음과 류사한 중지대화 
칸을 제공해 야 한다. (이 대 화칸에 대 한 코드는 

QSessionManager : :allowsInterac 社 on () 의 문서 에 있다.) 



그림 4-2. 중지 대화칸 

또한 완전한 쎄숀관리(현재 X 11 R 6 에서만 지원됨)를 위해서는 응용프로그람의 상 
태 보관과 잠재 적 으로 쎄 손의 다음 생 명 주기 에 서 상태 의 되 살리 기 를 고려해 야 한다. 이 
보관은 QApplication : : saveState () 의 재정의에 의해 수행된다. 이 함수에서 보관하고 
있는 모든 상태자료는 쎄손식별자 QApplication :: sessionId () 에 의해 표식되여야 한다. 
응용프로그람에 고유한 식별자는 대역적으로 유일하므로 충돌이 생기지 않는다(특정한 
Qt 응용프로그람의 상태보관과 되살리기에 대한 정보는 QSessionManager 를 참고). 

되살리 기는 보통 응용프로그람의 mainO 함수에서 수행된다. QApplication :: 
isSessionRestoredO 가 TRUE 인가 검사한다. 그 경우에 다시 쎄숀식별자 
QApplication :: sessionldO 를 사용하여 자기 의 상태 자료를 호출하고 응용프로그람의 
상태를 되살린다. 

중요: 창문관리기가 탄창보관순서 혹은 기하정보와 같은 창문속성들을 되살리기 위 
해서는 자기의 유일한 응용프로그람범위의 객체이름들을 가지는 제 일웃준위의 창문부품 
들을 식별하여야 한다 ( QObject::s 하 NameO 참고). 응용프로그람을 되살릴 때 되살아나 
는 제일 웃준위의 모든 창문부품들이 이전에 가지고있던것과 같은 유일한 이름들을 가지 
도록 담보하여 야 한다. 

5. 쎄손관리의 시험과 오유수정 

Mac OS 표와 Windows 에서 쎄손관리지원은 조작체계 그 자체에 이런 기능이 없 
는것으로 하여 상당히 제한된다. 단순히 쎄숀을 중지하고 자기의 응용프로그람이 기대한 
대로 동작하는가를 확인한다. 자기 응용프로그람을 기동하기전에 다른 응용프로그람, 보 
통 통합개발환경을 기동하는데 사용할수 있다. 이러한 다른 응용프로그람은 후에 중지통 
보를 엄 으므로 중지 를 취 소하게 한다. 그렇 지 않으면 매 번 시 험 후에 다시 가입 (log in ) 
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해야 하는데 이것은 그자체에 문제가 없지만 시간을 소비한다. 

Unix 에서는 표준 X 11 R 6 쎄손관리를 유지 하는 탁상환경을 사용하거 나 X 협회 에 의해 
제공된 쎄숀관리기참고실현을 사용할수 있다. 이 본보기관리기를 xsm 이라고 부르며 표 
준 X 11 R 6 설치의 부분이다. XII 에서는 항상 사용할수 있는 man 폐지가 제공된다. xsm 
의 사용은 간단하다. ( AOiena 기초사용자대면부와 다르다.) 여기에 간단한 수법이 있다. 

• X 11 R 6 을 실 행한다. 

• 단일행을 포함하는 자기의 홈등록부에 점파일 . xsmstartup 을 창조한다. 

xterm 

이것은 xsm 에게 기정 및 실패에 안전한 쎄숀이 바로 xterm 이라는것을 말한다. 그 
렇지 않으면 xsm 은 그리 도움이 되지 않는 창문관리기 twm 을 포함하는 많은 의뢰기들 
을 호줄하려고 한다. 

• 이제 다른 말단창문으로부터 xsm 을 호출한다. 쎄숀관리기창문과 xterm 이 둘다 
나타난다. xterm 은 현재 실행하고있는 다른 모든 월로부터 분리하여 설정되는 좋은 속 
성 을 가지 고있 다. 이 엘 안에 서 SESSION _ MANAGER 환경 변수는 바로 자기 가 기 동한 
쎄손관리기를 지적한다. 

• 새로운 xterm 창문으로부터 자기의 응용프로그람을 호출한다. 그자체를 쎄숀관리기에 자 
동적으로 련결한다. 련결이 성공하였는가는 Clien 仕 Jst 누름단추를 리용하여 검사할수 있다. 

알아두기: 쎄숀관리되는 의뢰기들을 기동하거나 완료할 때 ClientList 는 절대로 열 
려있지 않다. 그렇지 않으면 xsm 은 중단될수 있다. 

• 쎄손관리기의 Checkpoint 와 Shutdown 단추들에 서로 다른 설정값들을 사용하 
여 자기 응용프로그람의 동작을 고찰해본다. 보관형 local 은 의뢰기들이 그 상태를 보관 
해야 한다는것을 의미한다. 이것은 QApplication : : saveState () 함수에 대응된다. 
global 보관형은 응용프로그람들에게 보관되지 않은 변경 을 영 원히 대 역 호출기억 기 에 보 
관할것을 요구한다. 이것은 QApplication : : commitData () 를 호출한다. 

• xsm 은 사용자의 탁상에 서 사용가능한 쎄 숀관리 기 의 존재 로부터 분리 되 여있 다. 
시험환경으로 봉사하는데 충분히 안정하고 쓸모있다. 


제15절. 공유클라스 

Qt 의 수많은 C ++ 클라스들은 명시 적 ( explicit ) 이 고 암시 적 ( implicit ) 인 자료공유를 사 
용하여 자원리용률을 최 대 화하고 자료복사를 최 소화한다. 

공유콜라스는 참고계 수와 자료를 포함하는 공유자료블로크의 지 적자로 이 루어 진다. 

공유객체가 창조될 때 참고계수는 호로 설정된다. 참고계수는 새 객체가 공유자료를 
참고할 때마다 늘어 나고 객체 가 공유자료참고를 해제할 때마다 줄어든다. 참고계수가 0 
으로 될 때 공유자료는 삭제된다. 

공유객체들을 취급할 때 객체를 복사하는 두가지 방법 즉 깊은 복사와 얕은 복사가 
있다. 깊은 복사 (deep copy ) 는 객체의 복제를 암시한다. 얕은 복사 (shallow copy ) 는 
참고복사 즉 공유자료블로크의 지적자이다. 깊은 복사는 기억기와 CPU 의 측면에서 비 
용이 든다. 얕은 복사는 아주 고속이다. 그것은 지적자의 설정과 참고계수의 증가만 포 
함하기때 문이 다. 

명 시 적 및 암시 적 공유객 체 들을 위 한 객 체 대 입 ( operator = ()) 은 얕은 복사에 의 하여 
실현된다. 깊은 복사는 copyO 함수의 호출이나 QDeepCopy 를 리용하여 이루어진다. 

공유의 리득은 필요없이 자료를 복제할 필요가 없는것이고 그 결과 작은 기억기를 
사용하고 자료의 복사가 적어 진다. 객 체 들을 간단히 대 입 하고 함수인수로서 보내 고 함수 
로부터 돌려줄수 있다. 
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그러면 명시적 및 암시적공유사이의 차이를 보자. 명시적공유는 프로그람작성자가 
객체들이 공통자료를 공유한다는 사실을 알아야 한다는것을 의미한다. 암시적공유는 공 
유기구가 배경에서 발생하므로 프로그람작성자가 그에 대해 걱정할 필요가 없다는것을 
의미 한다. 

1. QByteArray 실례 

QByteArray 는 명시적공유를 사용하는 공유들라스의 실례이다. 실례 : 

// Line a= b= c= 

QByteArray a(3),b(2) //l： {?，?，?} {?，?} 

b[0] = 12; b[l] = 34; 111: {?,?,?} {12,34} 

a = b; //3: {12,34} {12,34} 

a[l] = 56; //4: {12,56} {12,56} 

QByteArray c = a; II5: {12,56} {12,56} {12,56} 

a.detach(); "6: {12,56} {12,56} {12,56} 

a[l] = 78; 111: {12,78} {12,56} {12,56} 

b = a.copy(); II 公 .. {12,78} {12,78} {12,56} 

a[l] = 90; II9: {12,90} {12,78} {12,56} 

3 행 의 대 입 a = b 는 a 의 원시 공유블로크를 버리 고(참고계 수는 0 으로 된 다) a 의 공유블로크 
가 b 의 공유블로크를 지 적 하게 설 정 하고 참고계 수를 증가시 킨 다. 

4 행 에 서 a 의 내 용은 수정 되 고 a 와 b 가 같은 자료블로크를 참고하므로 b 도 역 시 수정 된 다. 
이 것 은 명 시 적 공유와 암시 적 공유사이 의 차이 이 다. 

6행 에 서 객 체 a 는 공통자료로부터 분리 된 다. 분리 는 객 체 가 그 자체 의 비 공개 자료를 가진 
다는것을 확인하도록 공유자료가 복사된다는것을 의미한다. 그러므로 7 행 에서 a 의 수정은 b 나 
c 에 영 향을 주지 않는다. 

끝으로 8 행 에 서 는 a 의 깊은 복사를 만들고 그것 을 b 에 대 입 하여 9 행 에 서 a 가 수정 될 때 b 
는 변경되지 않는다. 

2. 명시적공유와 암시적공유 

암시적공유는 객체가 변경되려고 하고 참고계수가 1보다 크면 자동적으로 그 객체 
를 공유블로크에서 분리 한다. (이것을 흔히 《써 넣을 때의 복사 ( copy - on - write ) 》라고 
한다. ) 명 시적공유는 이 일감을 프로그람작성 자에게 넘 긴다. 명시적공유객체 가 분리 되지 
않으면 객체의 변경은 같은 자료를 참고하는 다른 모든 객체들을 변경하게 된다. 

암시적공유는 이러한 부작용이 없이 기억기의 사용과 자료의 복사를 최적화한다. 
그러면 왜 모든 공유콜라스들에 암시적공유를 실현하지 않았는가? 대 답은 QByteArray 
와 같은 그 내부자료에 대한 직접호출을 허용하는 콜라스를 효과성때문에 명시적으로 공 
유할수 없다는것이다. 그것은 QByteArray 가 모르게 변경될수 있기때문이다. 

암시적공유콜라스는 그 내부자료의 종합적조종을 가전다. 따라서 그 자료를 수정하 
는 임의의 성원함수들에서 자료를 수정하기전에 자동적으로 분리한다. 

암시 적 공유를 사용하는 QPen 콜라스는 내 부자료를 변경 하는 모든 성 원함수들에 서 
공유자료로부터 분리한다. 

코드부분: 

void QPen ： : setStyle ( Pen Style s ) 

{ 

detach 0; // detach from common data 

data->style = s ; // set the style member 

} 


void QPen :: detach 0 





if ( data->count != 1 ) // only if >1 reference 
*this = copyO ; 


이것은 프로그람작성자가 다음과 같이 할수 있으므로 QByteArray 에는 명백히 불가능하다. 
QByteArray array ( 10 ); 
array . fill ( ’ a ’ ); 

array [0] = ’ f ’; // will modify array 

array . data () [1] = ’i ; // will modify array 

QByte Array 에서의 변화를 감시한다면 QByteArray 클라스는 접수할수 없을 정도 
로 떠진다. 

3. 명시적공유클라스 

QMemArray 형판콜라스의 실례인 모든 클라스들은 명시적으로 공유된다. 

QBitArray , QPointArray , QByteArray , QMemArray < type > 의 다른 실례작성이 
콜라스들은 자기의 객체가 공유자료의 비공개사본을 엄으려고 하면 호출될수 있는 
detach 0함수를 가지며 참고계수 1을 가지는 깊은 사본을 돌려주는 copy 0함수를 가진다. 

이리한것은 QMemArray 를 계승하지 않는 Qlmage 에서도 같다. QMovie 도 역시 
암시적으로 공유되지만 detach ()4 copy 0를 가지지 않는다. 

4. 암시적공유클라스 

암시적 으로 공유하는 Qt 들라스들은 다음과 같다. 

QBitmap , QBrush , QCursor , QFont , QFontlnfo , QFontMetrics , QlconSet , 
QMap , QPalette , QPen , QPicture , QPixmap , QRegion , QRegExp , QString , 
QStringList , QValueList , QValueStack 

이 콜라스들은 객체를 변경하려고 할 때 자동적으로 공통자료로부터 객체를 분리한 
다. 프로그람작성자는 객체들이 공유된다는것을 전혀 알리지 않는다. 이리하여 클라스들 
의 개별적인 실례들을 개별적객체로 취급해야 한다. 그것들은 늘 개별적객체들로 동작하 
지만 가능할 때마다 추가적인 공유객체의 우점을 가진다. 이러한 리유로 복사비에 관계 
없이 함수들에 이 콜라스들의 실례들을 값에 의해 인수로서 넘길수 있다. 

실례 : 

QPixmap pi , p 2； 

pi . load ( ’’ image . bmp " ); 

p 2 = pi ; // pi 과 p 2 은 자료를 공유한다 

QPainter paint ; 

paint , begin ( & p 2 ); // cuts p 2 loose from pi 

paint . drawText ( 0,50, " Hi " ); 
paint , end 0 : 

이 실례에서 p 2 에 대하여 QPainter :: begin 0가 호출될 때까지 pi 와 p 2 은 자료를 
공유한다. 왜냐하면 픽스매프의 그리기가 그 자료를 수정하지 않기때문이다. 또한 어떤 
것이 p 2 로 bitBltO 되지 않으면 같은 일이 발생한다. 

경고: 자기 가 암시적공유용기 ( QMap , QValueVector , 등)에 관심을 가지지 않을 
때 그것을 복사하지 말아야 한다. 

5. QCString 은 암시적인가 명시적인가? 

QCString 은 암시적공유와 명시적공유를 혼합하여 사용한다. QByteArray 로부터 
계승된 dataO 와 갈은 함수들은 명시적공유를 받아들이고 QCString 안의 함수들은 자동 
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분리한다. 이처럼 QCString 은 주로 Qt 1 .x 로부터 Qt 2.0 으로 간단히 이식하기 위하 
여 제 공되는 전문가전용들라스이 다. 순수한 명시적 공유콜라스인 QString 를 사용할것 을 
권고한다. 


제16절. 형식개팔 

Qt 에서 형식 ( style ) 은 특별한 가동환경용의 GUI 에서 찾게 되는 형식을 실현한다. 
실례로 Windows 가동환경은 Windows 혹은 Windows XP 형식을 사용할수 있고 
Unix 가동환경은 Motif 형식을 리용할수 있다. 

이것은 Qt 3 .x 형식 API 를 가지고 사용자정의형식을 창조하고 리용하도록 하는데 
요구되는 단계들을 보여주는 간단한 차림표이다. 우선 필요한 단계들을 거 처서 형식을 
생 성한다. 즉 

① 계 승하려 는 기 초형 식 을 선택한다. 

② 파생콜라스에서 필요한 함수들을 재정의한다. 

그다음 자기 응용프로그람이나 현존 Qt 응용프로그람들에서 사용할수 있는 플라그인 
으로서 새 형식을 사용하는 방법을 설명한다. 

- 사용자정의형식창조 

5) 계승하려는 기초형식을 선택한다. 

첫 단계는 Qt 에 제공된 기본형식들중 하나를 선택하여 자기의 사용자정의형식을 구 
축하는것이다. 그 선택은 자기가 얻으러는 형식에 의존한다. QWindowsStyle 파생들라 
스 혹은 QMotifStyle 파생콜라스로부터 선택 할것을 권고한다. 이 클라스들은 Qt 형 식 엔 
진의 두가지 기초형식클라스들이다. QCommonStyle 로부터의 직접계승은 자기 형식을 
새로 실현하려고 하는 경우의 선택이다. 이 간단한 실례에서는 QWindowsStyle 로부터 
계승한다. 

② 파생클라스에서 필요한 함수들을 재정의한다. 

기초형식의 어느 부분을 변경하려고 하는가에 따라서 이 부분의 대면부를 그리는데 
사용되 는 함수들을 재정의하여 야 한다. QStyle 문서 를 조사해 보면 각이 한 통지 
( primitive ) 와 조종， 복합조종들의 목록을 볼수 있다. 이 실례에서는 우선 
QWindowsStyle 에서 쓰이는 표준화살표들의 모양을 변경 한다. 화살표들은 
drawPrimitiveO 함수에 의해 그려지는 PrimitiveElement 이므로 그 함수를 재정의하 
여야 한다. 다음의 클라스선언이 요구된다. 

# include 〈 qwindowsstyle . h > 


class CustomStyle : public QWindowsStyle { 

Q_OBJECT 

public ： 

CustomStyle () : 

~CustomStyle 0 : 

void drawPrimitive ( PrimitiveElement pe , QPainter * p , const QRect & r , 
const QColorGroup & eg , SFlags flags = Style _ Default , 
const QStyleOption & ^ QStyleOption： : Default ) const ； 


private ： 

// 복사구성자와 연산자=를 금지한다 
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CustomStyle ( const CustomStyle & ) ； 

CustomStyle 技 operator : ( const CustomStyle 技 ) ； 

}； 

우리의 형식에서 복사구성자와 =연산자를 허용하지 않는다. QObject 는 Qt 의 모든 
형식클라스들의 기초클라스이며 QObject 는 복사할수 없다는 자기의 견해가 있으므로 
복사될수 없다. 

QStyle 문서로부터 PE _ ArrowUp , PE _ ArrowDown , PE_ArrowLeft 그리고 
PE_ArrowRight 가 무엇€가 수행 하는데 요구되 는 통지 라는것 을 알수 있 다. 
drawPrimitiveO 함수에서 다음과 같은것을 얻게 된다. 

CustomStyle ： : CustomStyle () 

{ 

} 

CustomStyle : 卜 CustomStyle 0 

{ 

} 

void CustomStyle ： : drawPrimitive ( PrimitiveE 1 ement pe , QPainter * p , 
const QRect & r , 

const QColorGroup & eg , SFlags flags , const QStyleOption & 

opt ) const 

{ 

// 화살표에만 관심을 가전다 

if ( pe 〉= PE_ArrowUp 技技 pe <= PE _ ArrowLeft ) { 

QPointArray pa ( 3 ) ； 

// 화살표가 그리 려는 구역 절반을 포함하게 한다 

int x = r . x () ; 

int y = r . y ()； 

int w = r . width () / 2； 

int h = r . height () / 2； 

x += ( r . width () - w ) / 2； 

y += ( r . height 0 - h ) /2； 


switch ( pe ) { 
case PE _ ArrowDown : 
pa . setPoint ( 0, x , y ) ； 
pa . setPoint ( 1, x + w , y )； 
pa . setPoint ( 2, x + w / 2, y + h ); 
break ； 

case PE _ ArrowUp ： 
pa . setPoint ( 0, x , y + h ) ； 
pa . setPoint ( 1, x + w , y + h ); 
pa . setPoint ( 2, x + w / 2, y ) ； 
break ； 

case PE _ ArrowLeft : 
pa . setPoint ( 0, x + w , y )； 
pa . setPoint ( 1, x + w , y + h ); 
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pa . setPoint ( 2, x , y + h / 2 )； 
break ； 

case PE _ ArrowRight : 
pa . setPoint ( 0, x , y ) ； 
pa . setPoint ( 1, x , y + h )； 
pa . setPoint ( 2, x + w , y + h / 2); 
break ； 

default ： break ； 

} 

// 다른 색을 리 용하여 화살표가 허용/금지된다는것을 가리 킨다 
if ( flags & Style_Enabled ) { 
p -> setPen ( eg . mid 0 ); 

p->setBrush ( eg . brush ( QColorGroup ： : ButtonText ) ) ； 

} else { 

p -> setPen ( cg.buttonTextO ) ； 

p -> setBrush ( eg . brush ( QColorGroup： : Mid ) ) ； 

} 

p->drawPolygon ( pa ) ； 

} else { 

// 기초형식 이 다른 원시형식을 조종하게 한다. 

QWindowsStyle ： : drawPrimitive ( pe , p , r , eg , flags , data ) ； 

} 

} 

③ 사용자정의형식의 리용 

Qt 응용프로그람에서 사용자정의형식을 사용하는 몇가지 방법이 있다. 가장 간단한 
방법 은 응용프로그람의 main () 함수에 서 다음의 코드행 을 포함하는것 이 다. 

#include " customstyle . h " 

int main ( int arge , char ** argv ) 

{ 

QApplication ： : setStyle ( new CustomStyleO ) ； 

// QApplication 객체를 창조하는 보통의 루린. 

} 

또한 자기의 프로젝트에 customstyle.h 와 customstyle.cpp 파일들을 포함해야 
한다. 

④ 플라그가능한 형식의 창조와 리용 

자기의 형식을 자기가 작성한 응용프로그람들이나 다른 응용프로그람들에서 재콤파 
일하지 않고 사용할수 있게 만들려고 할수 있다. Qt Plugin 체계는 형식을 플라그인으 
로 창조할수 있게 한다. 플라그인으로 창조된 형식들은 Qt 자체에 의하여 실행시에 공유 
객체로서 적재된다. 

자기의 플라그인을 를파일하고 그것을 $ QTDIR / plugins/styles 에 넣는다. 그러 
면 Qt 가 자동적재할수 있는 플라그가능형식을 가지게 된다. 현존 응용프로그람들에서 
새로운 형식을 사용하려면 다음의 인수로 응용프로그람을 기동해야 한다. 

./application -style custom 

응용프로그람은 자기 가 실현한 사용자정의형 식 으로부터 형식을 사용한다. 
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제 17 절. Qt 형판서고 

Qt 형 판서고 (QTL) 는 객 체 용기 들을 제 공하는 형 판들의 모임 이 다. 적 당한 STL 실 현 
을 자기의 모든 목표가동환경에 사용할수 없으면 QTL 을 그대신에 사용할수 있다. 이것 
은 객체들의 목록, 객체들의 벡토르(동적배럴), 서로 관련한 형들의 매프(사전이나 련상 
배렬이라고도 한다) 그리고 련상반복자들과 알고리듬들을 제공한다. 용기는 다른 객체들 
을 포함하고 관리하는 객체이며 포함된 객체들을 호출하는 반복자들을 제공한다. 

QTL 클라스들의 명 명 관례 는 다른 Qt 콜라스들과 일 치한다(실 례 로 count(), 
isEmptyO). 또한 그것들은 sizeO 와 empty 0 와 같은 STL 알고리듬들과 호환되는 함 
수들을 제공한다. 이미 STL map 에 습관된 프로그람작성자들은 자기가 좋아한다면 
STL 호환함수들을 사용할수 있다. 

STL 과 비교하면 QTL 은 오직 STL 용기 API 의 가장 중요한 특성만 포함하며 비교하 
면 QTL 은 가동환경 차이를 가지지 않지만 보통 좀 느리고 적은 목적 코드를 전개한다. 

보관하려고 하는 객체들의 사본을 만들수 없으면 QPtrCollection 과 동료들을 사용 
해야 하며 그 모두는 값이 아니라 지적자에 대하여 조작한다. 실례로 이것을 QObject 
로부터 파생 된 모든 콜라스들에 적 용한다. QObject 는 복사구성자를 가지 지 않으므로 
값으로 사용할수 없다. QValueList 에 QObject 의 지적자들을 보관하는것으로 설정할수 
있으나 QPtrList 의 직접사용은 이러한 종류의 응용프로그람분야에 더 좋은 선택일수 있 
다. QPtrCollection 에 기초한 다른 모든 용기들처럼 QPtrList 는 속도에 관하여 최적 
화된 값에 기초하는 용기보다도 훨씬 더 옳은 검사를 제공한다. 

값의미를 실현하는 객체들이 있고 STL 을 자기의 목표가동환경에서 사용할수 없으 
면 Qt 형판서고를 그대신 사용할수 있다. 값의미 (value semantics) 는 적어도 다음것을 
요구한다. 

• 복사구성자， 

• 대입 연산자， 

• 기정구성자 즉 인수를 가지지 않는 구성자. 

수많은 복사조작이 제기되므로 용기의 좋은 성능을 얻는데서 고속복사구성자가 절 
대적으로 모든것을 결정 한다. 

자기 자료를 정렬하려고 한다면 자기 자료의 들라스에 operator<() 를 실현해야 한다. 

값에 기초한 클라스들의 좋은 후보는 QRect, QPoint, QSize, QString 및 int, 
bool 혹은 double 과 같은 C++ 기본형들이다. 

Qt 형판서고는 속도에 맞게 설계되므로 반복자들은 아주 빠르다. 이러한 성능을 달 
성하기 위하여 QPtrCollection 기초용기들에서보다 적은 오유검사를 수행한다. 실례로 
QTL 용기 는 련상된 반복자들을 추적하지 않는다. 이것은 일정한 유효성 검사가 (실례 로 
항목을 삭제 하고있 을 때 ) 자동적 으로 수행 될 수 없 게 하지 만 아주 좋은 성 능을 발휘하게 
한다. 


1. 반복자 

Qt 형 판서고는 지 적 자가 아니 라 값객 체 들을 취 급한다. 그러 므로 용기 들을 순환하는 
수단은 반복자밖에 없다. 이것은 반복자의 크기 가 표준지적 자의 크기와 일치할 때 결함 
이 없다. 

용기를 순환하려면 다음과 같이 순환을 사용한다. 
typedef QValueList<int> List； 

List list； 

for( List :: Iterator it = list.begin() : it != list.end0 ； ++ it ) 
printf ( "Number is %i\n", *it ) : 
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beginO 은 첫 요소를 가리키는 반복자를 돌려주고 end () 는 마지막 요소다음을 가 
리키는 반복자를 돌려준다. end () 는 무효한 위 치를 표식하므로 그것을 간접참고할수 없 
다. 이것은 시작점이 beginO 이든 fromLastO 이든 관계없이 반복에서의 중지조건이다. 
최대속도를 위하여 뒤붙이연산자 ( it ++， it —) 대신에 현저히 더 빠른 앞붙이연산자 (++ it ， 
— it ) 를 가지는 증가 혹은 감소반복자들을 사용한다. 

같은 개념을 다른 용기클라스들에 적용할수 있다. 
typedef QMap < QString , QString > Map ； 

Map map ； 

for ( Map ： : iterator it = map . beginO ; it != map . end () : ++it ) 
printf ( " Key=%s Data =% s \ n ", it . key 0. ascii 0, it . data 0. ascii 0 ); 


typedef QValueVector < int > Vector ； 

Vector vec ； 

for ( Vector ： : iterator It = vec . beginO ; it != vec . end () : ++it ) 
printf ( " Data =% d \ n ", *it )； 

두 종류의 반복자 즉 우의 실례들에서 보여준 volatile 반복자와 현재 객체에로의 
const 참고를 돌려주는 Constlterator 가 있다. const 반복자들은 const 함수안의 성원변 
수처럼 용기자체가 const 일 때 요구된다. 표준 Iterator •의 Constlterator 에로의 대입은 
그것 이 violate const 이므로 허용되지 않는다. 

2. 알고리듬 

Qt 형판서고는 그 용기들에 대하여 조작하는 많은 알고리듬을 정의한다. 이러한 알 
고리 듬들은 형 판함수들로 실현되 며 반복자들을 제 공하는 용기(자체의 용기들을 비 롯하 
여)에 적용될수 있는 쓸모있는 범용코드를 제공한다. 

® qHeapSortO 

qHeapSortO 는 잘 알려 진 정 렬 알고리 듬을 제 공한다. 다음과 같이 그것 을 사용할수 
있 다. 

typedef QValueList < int > List ； 

List list ； 

list « 42 « 100 « 1234 << 12 « 8； 
qHeapSort ( list ); 

List list 2； 

list 2 « 42 « 100 « 1234 « 12 « 8； 

List ： iterator b = list 2. find ( 100 ); 

List ： iterator e = list 2. find ( 8 ); 
qHeapSort ( b , e ) ； 

double arr [] = { 3.2, 5.6, 8.9 }； 
qHeapSort ( arr , arr + 3 ) ； 

첫 실례는 전체목록을 정렬한다. 둘째 실례는 두 반복자들사이에 떨어지는 요소들 
즉 100, 1234, 12만 정 렬한다. 셋째 실례는 반복자들이 지 적자처 럼 작용한다는것과 지 
적자처 럼 취 급할수 있 다는것 을 보여 준다. 

자체의 자료형을 사용한다면 자기 자료의 클라스에 대하여 operator <() 를 실현해 
야 한다. 

정 렬형판들은 const 반복자들과 작업 하지 않는다. 
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② qSwapO 

qSwapO 는 두개 변수의 값들을 교환한다. 

QString second ( ’’ Einstein ” ); 

QString name ( " Albert " ) ； 
qSwap ( second , name ) ； 

③ qCountO 

qCountO 형판함수는 용기안의 값의 개수를 계수한다. 실례로 
QValueList < int > list ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 2 ) ； 
int c = 0； 

qCount ( list , begin (), list , end 0， 1, c ) ； // c == 3 

④ qFindO 

dFindO 형판함수는 용기안에서 값의 첫 출현을 찾는다. 실례 로 
QValueList < int > list ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 1 ) ； 
list . push _ back ( 2 ) ； 

QValueListIterator < int > it = qFind ( list , begin (), list , end 0， 2 ) ； 

⑤ qFillO 

qFillO 형판함수는 범위를 값들의 사본으로 채운다. 실례로 
QValueVector < int > vec (3) ； 

qFill ( vec . begin (), vec . endO , 99 ); // vec contains 99, 99, 99 

⑥ qEqual () 

dEqualO 형판함수는 두개의 범위에 대하여 그 요소들의 등가성을 비교한다. 첫 범 
위 안의 요소들이 둘째 범위안의 대응하는 요소들과 갈으면 (따라서 두 범위 가 유효이 여 
야 한다.) 매 범위안의 요소수를 고려 하지 않는다. 실례로 
QValueVector < int > vl (3) ； 
vl [0] = 1； 
vl [2] = 2； 
vl [3] = 3； 


QValueVector < int > v 2(5) ； 

v 2[0] = 1； 

v 2[2] = 2； 

v 2[3] = 3； 

v 2[4] = 4； 

v 2[5] = 5； 


bool b = qEqual ( vl.begin 0， v 2. end (), v 2. begin () ) ； 

// b == TRUE 
⑦ qCopyO 

qCopyO 형판함수는 한 범위의 원소들을 Outputlterator (이 경우에 
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QTextOStreamlterator ) 에 복사한다. 

QValueList < int > list ； 
list . push _ back ( 100 ); 
list . push _ back ( 200 ); 
list . push _ back ( 300 ); 

QTextOStream str ( stdout ) ； 

qCopy ( list , begin (), list , end (), QTextOStreamlterator ( str ) ) ； 

⑧ qCopyBackward () 

qCopyBackwardO 형판함수는 용기 혹은 용기의 일부를 Outputlterator 에 반대순 
서로 복사한다. 실례로 

QValueVector < int > vec (3) ； 
vec . push _ back ( 100 ) ； 
vec . push _ back ( 200 ) ； 
vec . push _ back ( 300 ) ； 

QValueVector < int > another ； 

qCopyBackward ( vec . begin (), vec . endO , another , begin () ) ； 

// ’ another ’ now contains 100, 200, 300 
// however the elements are copied one at a time 
//in reverse order (300, 200, then 100) 

⑨ QTL 반복자들 

임의의 Qt 형판서고반복자를 Outputlterator 로 사용할수 있다. 다음의 실례는 이것 
을 설명 한다. 

QStringList listl , list 2 ； 

listl « ” Weis n « ” Ettrich ” « " Arnt n « M Sue M ； 

list 2 « " Torben " « " Matthias "； 

qCopy ( list 2. begin (), list 2. end (), listl . begin () ) ； 

QValueVector < QString > vec ( listl . size (), ” Dave ” ) ； 
qCopy ( list 2. begin (), list 2. end (), vec . begin () ) ； 

이 코드부분의 끝에서 목록 listl 은 삽입되는 순서로 ” Torben ”, ’’ Matthias ”, 

” Arnt ”, ’’ Sue " 을 포함한다. 벡토르 vec 에는 삽입되는 순서로 " Torben ", " Matthias ", 
’’ Dave ”, " Dave ” 를 포함된다. 

새로운 알고리듬을 쓴다면 될수록 많은 용기에서 사용할수 있도륵 씨야 한다. 우의 
실례에서 qCopy 0에 의해 표준 C ++ 배렬을 간단히 출력할수 있다. 
int arr [] = { 100, 200, 300 }； 

QTextOStream str ( stdout ) ； 

qCopy ( arr , arr + 3, QTextOStreamlterator ( str ) ) ； 

3. 스트림 

언급한 모든 용기들은 적당한 스트림연산자들에 의해 계렬화될수 있다. 여기에 실 
례가 있다. 

QDataStream str (...) ； 

QValueList < QRect > list ； 

// ... fill the list here 
str « list ； 

용기는 다음과 갈은 방법 으로 다시 읽 어들일수 있다. 
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QValueList < QRect > list ； 
str » list ； 

같은 방법을 QStringList , QValueStack , QMap 에도 적용할수 있다. 

제18절. Qt 에서 스레드기능 

Qt 는 폼에서 Qt 기초가동환경에 의존하지 않는 스레드작성들라스들의 스례드유지， 
사건들을 발송하는 스레드에 안전한 방법, 여러가지 스레드들로부터 Qt 메쏘드들을 호출 
하게 하는 대역적 인 Qt 서고잠건을 제공한다. 

1. 스레드유지의 허용 

Qt 를 Windows 에 설치 할 때 스레드기능는 일부 름파일러 에서는 선택적 이다. 

Mac OS 표와 Unix 에서 스레드유지는 configure 스크립트를 실행시킬 때 -thread 
선택을 추가함으로써 허용할수 있다. 다중스레드프로그람들이 특수한 1比 c 와 같이 특별 
한 방법으로 련결되여야 하는 Unix 가동환경에서 설치과정에 개별적인 서고 libqt - mt 를 
창조하므로 스레 드프로그람들은 표준 Qt 서 고가 아니 라 이 서 고에 대 하여 (- lqt - mt 에 의 
해) 련결되여야 한다. 

두 가동환경에서 정의된 QT _ THREAD _ SUPPORT 마크로를 리용하여 를파일하여 
야 한다.(실례로 - DQT _ THREAD _ SUPPORT 로 름파일한다.) Windows 에서 이것은 
보통 qconfig . h 안의 항목에 의하여 수행된다. 

2. 스레드클라스들 

이 콜라스들은 스레드유지를 허용할 때 Qt 서고안에 만들어진다. 

• QThread - 새 스레드를 기동하는 수단들을 제공하며 새 스레드는 
QThread :: run () 재정의에서 실행을 시작한다. 이것은 Java 스레드콜라스와 비슷하다. 

• QThreadStorage - 스레드마다 자료기억기를 제공한다. 이 콜라스는 QThread 
에 의해 기동된 스레드에만 사용될수 있으며 가동환경에 고유한 API 에 의해 기동되는 
스레드에 사용할수 없다. 

• QMutex - 호상배제 형 잠건 (뮤텍 스) 을 제 공한다. 

• QMutexLocker - 자동적으로 QMutex 를 잠건하거나 여는 편의 쿨라스. 
QMutexLocker 는 복잡한 코드나 례외를 사용하는 코드에서 사용할수 있다. 

• QWaitCondition - 다른 스레드에 의 하여 작업 할 때까지 스레드를 일시 중지 하 
는 방법을 제공한다. 

• QSemaphore - 간단한 옹근수쎄마퍼를 제공한다. 

3. 중요한 정의들 

다중스레 드프로그람에 서 Qt 를 사용할 때 재입 구가능과 스레 드안전 이 라는 용어 들을 
리 해 하는것 이 중요하다. 

• 재 입 구가능- 함수호줄시 마다 유일 한 자료를 참고하는 다중스레 드들에 의 
하여 동시 에 호출될 수 있는 함수를 서 술한다. 재 입 구가능함수를 동시 에 갈은 이 틈으로 호출하 
는것 은 불안전하며 이 와 갈은 호출은 련속적 이 여 야 한다. 

• 스레 드안전(功 reackq / 능) - 호줄시 마다 공유자료를 호줄할 때 다중스레 드에 의 하여 
동시에 호출될수 있는 함수를 서술한다. 스레드안전함수를 동시에 갈은 자료를 가지고 
호출하는것 은 안전하므로 공유자료에 로의 모든 접 근은 련속적 이 다. 

Qt 는 암시적으로 공유된 콜라스들과 명시적으로 공유된 들라스들을 둘다 제공한다. 

대 부분의 C ++ 성 원함수들은 선천적 으로 재입 구가능하므로 오직 클라스성 원자료들을 
참고할뿐이다. 하나의 스레드는 다른 어떤 스레드도 한 실례에 대하여 성원함수를 호출 
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하지 않는한 같은 실례에 대하여 그러한 성원함수를 호출할수 있다. 실례로 콜라스 
Number 를 주었다. 

class Number 

{ 

public ： 

inline Number ( int n ) : num ( n ) { } 

inline int number () const { return num ； } 
inline void setNumber ( int n ) { num = n ； } 

private ： 
int num ； 

}； 

메 쏘드 Number::number() 와 Number::setNumber() 는 재입 구가능이 므로 유일 한 자료를 
참고한다. Number 의 매 실례 에 대 하여 한번에 오직 하나의 스레 드만이 성 원함수들을 호출 
할수 있다. 하지만 다중스레드는 Number 의 개별적인 실례에 대하여 성원함수를 호출할 
수 있다. 

보통 스레드안전함수들은 뮤텍스(실례로 QMutex ) 를 리용하여 공유자료에 대한 호 
출을 계렬화한다. 뮤텍스의 잠건과 열기의 추가비용으로 인하여 스레드안전함수들은 보 
통 재입구가능함수들보다 느리 다. 실례 로 아래 에 클라스 Counter 를 주었다. 
class Counter 
{ 

public ： 

inline Counter () { ++ instances ; } 

inline - Counter () { — instances ; } 

private ： 

static int instances ; 

}； 

정적인 ins 切 nces 옹근수의 수정은 계렬화되지 않으므로 이 콜라스는 스레드에 안전하 
지 않다. 그러므로 그것을 스레드안전하게 만들고 뮤텍스를 사용해 야 한다. 
class Counter 
{ 

public ： 

inline Counter () 

{ 

mutex . lockO : 

++ instances : 
mutex . unlockO : 

} 

private ： 

static QMutex mutex ； 
static int instances : 
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4. 스레드에 안전한 사건발송 

Qt 에서 하나의 스레드는 항상 도형사용자대면부이거나 사건스레드이다. 이것은 
QApplication 객체를 창조하고 QApplication : : exec () 를 호출하는 스레 드이 다. 이것은 
또한 프로그람이 기동할 때 mainO 을 호출하는 초기스레드이다. 이 스레드는 창문체계 
로부터 사건의 생성과 수신을 비롯하여 도형사용자대면부조작을 수행하게 하는 유일한 
스레 드이 다. (과는 두번째 스레 드에서 QApplication 창조와 QApplication : : exec 0에 
의한 사건순환고리실행을 유지하지 못한다. QApplication 을 창조하고 자기의 프로그람 
에서 mainO 함수로부터 QApplication : : exec 0를 호출하여 야 한다. 

창문부품의 자료를 현시하려고 하는 스레드들은 직접 그 창문부품을 수정할수 없으 
므로 QApplication : : postEvent 0를 사용하여 그 창문부품을 사건에 발송하여 야 한다. 
그 사건은 도형사용자대면부스레드에 의하여 후에 발송된다. 

보통 프로그람작성자는 창문부품에 보내온 사건에서 어떤 정보를 포함하려고 한다. 
(사용자정의사건들에 대한 자세 한 정보는 QCustomEvent 문서를 참고하시오.) 

5. 스레드와 QObject 파생콜라스들 

QObject 콜라스그자체 는 재입 구가능이 지 만 도형 방식 사용자대 면부스레 드가 아닌 스 
레드에서 QObject 를 창조하고 사용할 때 일정한 규칙들을 적용한다. 

起) Qt 서 고에 포함된 어떤 QObject 기초콜라스도 재입구가능이다. 이것은 모든 창문 
부품(실례로 QWidget 와 그 파생콜라스)， 조작체계핵심클라스(실례로 QProcess , 
QAccel , QTimer ) , 모든 망구축콜라스(실례로 QSocket , QDns ) 들을 포함한다. 

② QObject 와 그의 모든 파생콜라스들은 스레드에 안전하지 않다. 이것은 전체 사 
건송달체계를 포함한다. GUI 스레드는 자기의 QObject 파생들라스에 사건들을 송달하는 
동안 다른 스레드로부터 그 객체를 호출하고있다는것을 기억해두는것이 중요하다. 비 
GUI 스레드에서 QObject 를 사용하고있고 이 객체에 보내온 사건들을 조종하고있다면 
뮤텍스를 가지 고 자기 자료에 로의 모든 접근을 보호해 야 한다. 

③ 종속된 사건들이 송달을 기다리는 동안 QObject 의 삭제는 중단을 일으킬수 있 
다. 비 GUI 스레드로부터 직접 QObject 를 삭제 하지 말아야 한다. 그대신 
QObject : : deleteLater () 메쏘드를 사용하여 야 한다. 그러면 종속된 모든 사건들이 객체 
에 송달된 다음에 사건순환고리가 객체를 삭제하게 한다. 

6. Qt 서고 뮤텍스 

QApplication 은 창문체계함수에 대한 접근을 보호하는데 쓰이는 뮤텍스를 포함한 
다. 이 뮤텍스는 사건순환고리를 실행하는동안(실례로 사건을 송달하는 기간) 잠건되고 
사건순환고리가 일시 중지될 때 잠건이 해제된다. 

알아두기 : Qt 사건순환고리는 재귀적 이 고 서고뮤텍스는 사건순환고리 에 재 입구할 때 
(실례로 QDialog :: exec () 에 의해 이행금지대화칸을 실행할 때) 잠건이 해제된다. 

다른 스레드가 Qt 서고뮤텍스를 잠건할 때 사건순환고리는 사건처리를 중지하며 잠 
건하는 스레 드는 단순한 GUI 조작을 수행할수 있 다. QPainter 의 창조와 선분그리 기 와 
같은 조작은 단순한 GUI 조작의 실례이다. 

qApp -> lock () : 


QPainter p ； 
p . begin ( my widget ); 
p . setPen ( QColor ( " red " ) ); 
p . drawLine ( 0,0,100, 100 ); 


166 







p.endO : 


qApp -> unlock () : 

사건들을 생성하는 조작들은 어떤 비 GUI 스레드에 의하여 호출되지 말아야 한다. 
그러 한 조작들의 실례들은 다음과 같다. 

• QWidget , QTimer , QSocketNotifier , QSocket 혹은 다른 망들라스들의 창조. 

• QWidget 의 이동, 크기조절，표시 혹은 숨기기 . 

• QTimer 의 시 작이 나 중지 . 

• QSocketNotifier 의 허용과 금지 . 

• QSocket 혹은 다른 망들라스의 사용. 

일부 가동환경에서는 이 조작들에 의해 생성된 사건들을 잃는다. 

7. 스레드와 신호, 처리부들 

QObject 기초콜라스를 위한 규칙들을 따르는 한 신호-처리부기구를 개별적인 스레 
드에서 사용할수 있다. 신호-처리부기구는 동기적이고 신호가 발생될 때 모든 처리부는 
즉시 호출된다. 처리부는 신호를 발생한 스레드문맥에서 실행된다. 

경 고: 창문체 계 사건들을 생 성 하거 나 창문체 계 함수들을 사용하는 처 리 부들은 비 GUI 
스레드로부터 발생되는 신호와 련결되지 말아야 한다. 

8. 스레드와 공유자료 

Qt 는 많은 암시 적공유콜라스와 명시 적 공유들라스들을 제 공한다. 다중스레 드프로그 
람에서 공유들라스의 여러개의 실례들이 공유자료를 참고할수 있는데 하나이상의 스레드 
들이 그 자료를 수정하려 고 시 도한다면 위 태 로워 진다. 어는 QDeepCopy 콜라스를 제 공 
하는데 이 콜라스는 공유콜라스들이 유일자료를 참고하도록 담보한다 (15 절 참고). 

9. 스레드와 SQL 모듈 

련결은 그것을 창조한 스레드안에서만 사용될수 있다. 스레드들사이에서 련결의 
옮기기와 다른 스레 드로부터 질문의 창조는 유지되지 않는다. 

또한 QSqlDriver 들에 의 하여 사용된 제 3자가 제 공하는 서 고들은 다중스레 드프로 
그람에서 SQL 모둘사용에 관한 다른 제한을 강요할수 있다. 

10. 경고 

스레드프로그람을 작성할 때 주의하여 야 할 점 

• 우에 서 언급한것 처 럼 QObject 기 초콜라스들은 스레 드안전도 재입 구가능도 아니 다. 
이것은 모든 창문부품들(실례로 QWidget 와 그 파생들라스들)과 조작체계핵심클라스(실 
례로 QProcess , QAccel ) , 모든 망콜라스(실례로 QSocket , QDns ) 들을 포괄한다. 

•종속된 사건들이 송달되기를 기다리는동안 QObject 의 삭제는 중단을 일으킨다. 
GUI 스레드가 아닌 스레드에서 QObject 들을 창조하고 이 객체들에 사건을 발송하고있 
다면 QObject 를 직접 삭제하지 말아야 한다. 그대신 QObject :: deleteLater () 메쏘드를 
사용하여 모든 종속된 사건들을 객체에 발송한 다음에 사건순환고리가 그 객체를 삭제하 
게 한다. 

• Qt 서 고뮤텍 스를 보유하고있는동안 폐 색 조작을 수행하지 말아야 한다. 이 것은 사 
건순환고리를 동결시 킨다. 

•재귀적인 QMutex 를 잠건한 회수만큼 열고있는가 확인하여야 한다. 이것은 적어 
도 안되고 많아도 안된다. 

• 자기 응용프로그람에서 보통의 Qt 서고와 스레드화된 Qt 서고를 섞지 말아야 한다. 
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이것은 자기 응용프로그람이 스레드화된 Qt 서고를 사용한다면 보통의 Qt 서고와 련결하 
지 말고 보통의 Qt 서 고를 동적 으로 적 재하거 나 Qt 서 고에 의 존하는 다른 서 고나 플래 그 
인을 동적 으로 적재하여 야 한다. 일부 체 계 에서는 Qt 서 고에서 사용되 는 정적 자료를 못 
쓰게 할수 있 다. 

• Qt 는 둘째 스레드에서 QApplication 의 창조와 사건순환고리의 실행 
( QApplication :: exec () 에 의해)을 지원하지 않는다. 자기 프로그람에서 
QApplication 객체 를 창조하고 mainO 함수로부터 QApplication : : exec 0를 호출해 야 
한다. 


제 19 절. 시계 

모든 Qt 객체들의 기초클라스인 QObject 는 어의 기초시계기능을 제공한다. 
QObject : : startTimer () 에서 인수로서 ms 의 시격을 가지는 시계를 기동한다. 함수는 
유일한 옹근수인 시계 id 를 돌려준다. 현재 시계는 시계 id 를 가지고 명백히 
QObject : : killTimer () 를 호출할 때까지 매 시격마다《발화》된다. 

이 기구가 작업하려면 응용프로그람은 사건순환고리에서 실행되여야 한다. 
QApplication :: exec 0를 가지고 사건순환고리를 시작한다. 시계가 발화될 때 응용프로 
그람은 QTimerEvent 를 송신하고 조종의 흐름은 시계사건이 처리될 때까지 사건순환고 
리를 떠난다. 이것은 자기 응용프로그람이 다른 일로 분주할 때 시계를 발화할수 없다는 
것을 암시한다. 다시 말하면 시계의 정확도는 자기 응용프로그람의 립도 ( granularity ) 
에 의존한다. 

실천적으로 시격값에 대한 상한은 없다. (1 년이상도 가능하다.) 정확도는 기초하고 
있는 조작체계에 의존한다. Windows 95/98는 55 ms ( s 당 18. 2회)의 정확도를 가진 
다. 다른 체계들 (UNIX XII 와 Windows NT ) 은 1 ms 의 시격을 조종할수 있다. 

시계기능의 기본 API 는 QTimer 이다. 이 콜라스는 시계가 발화할 때 신호를 발생하 
는 정규시계를 제공하며 대부분의 GUI 프로그람들의 소유자구조에 아주 적합하도록 
QObject 를 계승한다. 그것을 사용하는 표준방법은 다음과 같다. 

QTimer * counter = new QTimer ( this ); 

connect ( counter , SIGNAL (timeout ()), this , 

SLOT ( updateCaption ()) ); 

counter -> start ( 1000 ); 

계수기시계는 이 창문부품의 자식으로 만들어지므로 창문부품이 삭제될 때 시계도 
삭제된다. 다음에 그 시간요구신호는 작업을 수행할 처리부에 련결되고 끝으로 그것이 
기동된다. 

또한 QTimer 는 단순한 한번발사시계 API 를 제공한다. QButton 은 이것을 사용하 
여 눌러운 단추를 표시하며 건반으로 단추를 누른 경우에 0.1 s 후에 단추를 놓는다. 실 
례로 

QTimer ： : singleShot ( 100, this , SLOT ( animateTimeout ()) ); 

이 코드행의 실행 0.1 s 후에 같은 단추의 animateTimeoutO 처리부가 호출된다. 

여기에 신호와 처리부를 통한 객체통신을 QTimer 객체와 결합하는 현저히 긴 실례 
의 륜곽을 보여 준다. 이것은 사용자대 면부를 폐 색 하지 않고 단일스레 드응용프로그람에서 
긴장한 계산을 수행하는데 시계를 사용하는 방법을 보여준다. 

// The Mandelbrot class uses a QTimer to calculate the mandelbrot 
// set one scanline at a time without blocking the CPU . It 
// inherits QObject to use signals and slots . Calling start () 
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// starts the calculation . The doneO signal is emitted when it 
// has finished . Note that this example is not complete , just an 
outline . 

class Mandelbrot : public QObject 

{ 

Q_OBJECT // required for signals/slots 
public ： 

Mandelbrot ( QObject * parent =0, const char *name ) ； 


public slots ： 
void start () ； 
signals ： 
void doneO ； 
private slots ： 
void calculate () ； 
private ： 

QTimer timer ； 


// Constructs and initializes a Mandelbrot object . 

Mandelbrot ： ： Mandelbrot ( QObject * parent =0, const char *name ) 
: QObject ( parent , name ) 

{ 

connect ( & timer , SIGNAL (timeout ()), SLOT (calculate ()) ) ； 


// Starts the calculation task . The internal calculate () slot 
// will be activated every 10 milliseconds . 

void Mandelbrot ： : start () 

{ 

if ( ! timer . isActiveO ) // not already running 
timer , start ( 10 ) ； // timeout every 10 ms 

} 

// Calculates one scanline at a time . 

// Emits the doneO signal when finished . 

void Mandelbrot ： : calculate () 

{ 

… // perform the calculation for a scanline 

if ( finished ) { //no more scanlines 
timer , stop () ； 
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emit doneO ; 

} 


제 20 절. Qt 창문부품들의 화상 

대부분의 창문부품들을 Motif 혹은 Windows 형식으로 표시한다. 모든 창문부품들 
은 두 형식(그리고 다른 형식)으로 유지되지만 명백성때문에 바로 선택을 표시한다. 

Qt 는 아래 에 보여준 선택 이상으로 창문부품들을 제공한다. 그리고 여분의 Qt 를 제 
3자로부터도 사용할수 있으며 Qt 에 대한 추가로서 사용할수도 있다. 

그림 4-3 에 QSplitter 에 의해 분리 된 3개 의 보기 가 있 다. 왼쪽우에 QListBox 가 
있고 오른쪽우에 하나의 QHeader 와 두개의 QScrollBar 를 가진 QListView 가 있다. 
그리고 아래에 QlconView 가 있다._ 


현 F % % % 

! Actions] User Settings Global Settings Plugins 

% % % 

Administration Network Update 



| Description 

Help and Documentation 
Extra Operations 
Edit Operations 

ffl Paste Paste the data from the clipboarc 
Copy Copy the selection to the clipbo< 
■H Cut Cut the selection " 

File Operations 

Print out the contents of the docL 


그림 4-3. QSplitter 에 의해 분리된 3개의 보기 

그림 4-4 에 하나의 QMenuBar 그리고 QToolButton 들과 QComboBox 와 같은 
각종 창문부품들을 포함하는 QToolBar 들을 가지는 QMainWindow 를 제시 한다. 중심 
창문부품은 MDI 창문관리에 쓰이고 QTextEdit 를 특징짓는 MDI 창문을 포함하는 
QWorkspace 이다. 바닥에 하나의 QStatusBar 가 있고 오른쪽밑에 하나의 QSizeGrip 
가 있다. 
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그림 4-4. QMainWindow 

아래의 화상은 QFileDialog 를 보여준다. Macintosh 와 Windows 가동환경에서 
QFileDialog 를 사용하거나 본래의 파일대화칸을 사용할수 있다. 이것은 QFileDialog 
클라스문서에서 설명한다. 


그림 4-5. QFileDialog 

그림 4-6 에 QPrintDialog 가 있다. Macintosh 와 Windows 에서는 본래의 인쇄대 
화칸이 쓰이지만 다른 가동환경에서는 QPrintDialog 를 제공한다. 가동환경에 의존하지 
않게 하려면 이식성을 위하여 QPrintDialog 대신에 QPrinter : : setup () 를 사용한다. 
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QPrintDialog 



From page： 







[ OK | Cancel | 

그림 4-6. QPrintDialog 

그림 4-7 에 QFon 切) ialog 가 있다. 



그림 4-7. QFontDialog 

그림 4-8 에 QColorDialog 를 보여준다. 
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Custom colors 

厂厂厂厂厂厂厂 
厂厂厂厂厂厂厂 

Define Custom Colors » 


運 


Add To Custom Colors 


그림 4-8. QC 이아 Dialog 

그림 4-9 에 보여주는것처럼 통보문들은 QMessageBox 에 의해 표시된다. 


Q Message Box 


影 


This is a QMessageBox with a 
message. It can even display 
Rich-Textf 


그림 4-9. QMessageBox 

그림 4-10 은 QProgressDialog 를 표시한다. QProgressBar 도 역시 개별적창문부 
품으로서 사용될수 있다. _ 



그림 4-10. QProgressDialog 

그림 4-11 에는 하나의 QLineEdit , 하나의 읽기전용 QComboBox 및 편집가능한 
하나의 QComboBox 를 포함하는 QGroupBox 가 있다. 
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그림 4-11. QGroupBox 

그림 4-12 는 QPopupMenu 를 보여준다. 

New 
으 pen 
Save 
Save as 
Print 
Quit 

그림 4-12. QPopupMenu 

그림 4-13 에 4 개의 QRadioButton 와 두개의 QCheckBox 들을 포함하는 
QButtonGroup 가 있다. 


- Group Box - 

分 Radiobutton 1 

C Radiobutton 2 

C Radiobutton 3 

C Radiobutton 4 

r Checkbox 1 

W Checkbox 2 




그림 4-13. QButtonGroup 


그림 4-14 는 QTabDialog 를 보여준다. 타브 ( QTabBar ) 혹은 하나의 타브띠와 
폐지들을 결합하는 더 편리한 클라스 QTabWidget 가 개별적으로 사용될수 있다. 폐지에 
서 하나의 QLabel , 범위조종요소들인 QSlider 와 QSpinBox , 그리고 아래에 하나의 
QLCDNumber 가 보인다. 바닥에 여러개의 QPushBu 竹 on 이 있다. 
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그림 4-14.QTabDialog 

그림 4-15 에 HTML 폐지를 현시하는 QTextBrowser 가 있다. 



General 

Getting Started 

What 

• About Qt 

• Installation 

• KevF 

• Common Problems 

• Tutorial 

Qt2.2 

• Windows vstem- specific 

• Walkthrouqh 

• Detail 

notes 

• Examples 

Notes 

• How to buv Qt 

1 

⑩ Chan 

⑩ Pn 


그림 4-15. QTextBrowser 


제21절. Qt 응용프로그람의 전개 

이 절에서는 Qt 응용프로그람들을 배포하는데 필요한 가동환경에 고유한 파일들을 
보여준다. 역시 요구될수 있는 를파일러에 고유한 파일들을 포함하지 않는다 (8 장 1절 
참고). 

1. 정적인 Qt 응용프로그람 

정적인 Qt 응용프로그람을 배포하려면 모든 가동환경에 대하여 자기 응용프로그람의 
실행파일이 필요하다. 

2. 동적인 Qt 응용프로그람 

동적인 Qt 응용프로그람을 배포하려면 모든 가동환경에 대하여 응용프로그람의 실행 
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파일과 Qt 서고파일들이 필요하다. 

Qt 서 고는 응용프로그람의 실행파일과 같은 등록부에，또는 체 계서 고경 로에 포함되 
는 등록부에 있어야 한다. 

서 고는 표 4-7 과 같은 가동환경 에 고유한 파일 들에 의하여 제 공된 다. 


표 4-7. 가동환경 에 고유한 Qt 서고파일 


가동환경 

파일 

Windows 

qt [ version ] .dll 

Unix/Linux 

libqt [ version ]. so 

Mac 

libqt [ version ]. dy lib 


version 은 3개의 판번호를 포함한다. 스레드구축일 때 판앞에는 앞붙이 -mtA 붙 

는다. 

- 플라그인의 배포 

응용프로그람이 요구하는 플라그인파일들을 포함해 야 한다. 

플라그인들은 Qt 에 플라그인등록부로 알려진 등록부아래의 보조등록부에 넣어야 한 
다. 보조등록부는 플라그인범주의 이름을 가져야 한다. (실례로 styles , sqldrivers , 
designer 등.) 

Qt 는 다음의 등록부들에서 플라그인범주를 검색한다. 

• 응용프로그람에 고유한 플라그인경로 
• Qt 의 구축등록부 

• 응용프로그람등록부 

응용프로그람에 고유한 풀라그인경 로는 QApplication :: addLibraryPa 仕 i () 에 의하 
여 추가할수 있 다. Qt 의 구축등록부는 Qt 서 고에 코드로 들어있으며 설 치 과정 의 일부로 
서 변경될수 있다. 

3. 동적대화칸 

동적대화칸에서 QWidgetFactory 를 사용한다면 모든 가동환경들에 다음과 같은 파 
일들이 요구된다. 

• 동적 Qt 응용프로그람들에 사용된것과 같은 파일들 

• QUI 서 고 

QUI 서 고는 표 4-8 과 같은 가동환경 에 고유한 파일 들에 의하여 제 공된 다. 


표 4-8. 가동환경에 고유한 QUI 서고파일 


가동환경 

파일 

Windows 

qui.lib 

Unix/Linux 

libqui.so 

Mac 

libqui.dylib 


QUI 서 고는 응용프로그람의 실행파일과 갈은 등록부에 있거 나 체 계서 고경 로에 포함 
되는 등록부에 있어 야 한다. 
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제 5 장. 기하학적배치 

제1절. 배치관리자클라스 

Qt 배치체계는 자식창문부품들의 배치를 지정하는 단순하고도 강력한 방법을 제공한다. 

론리적배치를 지정함으로써 다음의 리득을 얻는다. 

① 자식창문부품들의 위치지정. 

② 제 일 웃준위 창문부품들을 위한 감별 할수 있는 기 정 크기 들. 

③ 제일 웃준위 창문부품들을 위한 감별할수 있는 최소크기들. 

④ 크기 조종. 

⑤ 내용이 변할 때 자동갱신. 

•보조창문부품들의 서체크기，본문 혹은 기타 내용들. 

• 보조창문부품의 은폐 혹은 표시 . 

•보조창문부품들의 삭제. 

Qt 의 배치관리자클라스들은 손으로 작성하는 C ++ 코드용으로 설계되였으므로 리해 
와 사용이 간단하다. 

손으로 쓴 배치코드의 결함은자기가 폼설계를 실험하고있을 때와 변경시마다 를파 
일, 련결, 실행해야 하는 경우에 편리하지 못한것이다. 해결대책은 Qt Designer 를 사 
용하는것으로서 이것은 배치를 간단히 고속으로 하게 하고 C ++ 배치코드를 생성하는 시 
각적인 GUI 설계도구이다 . 

1 . 배 치 관리 자창문부품 

자기 창문부품들에 좋은 배치를 주는 가장 간단한 방법은 배치관리자창문부품 즉 
QHBox , QVBox , QGrid 를 사용하는것 이 다. 배 치 관리 자창문부품은 자식 창문부품들이 
구성되는 순서로 그것들을 자동적으로 배치한다. 더 복잡한 배치를 창조하려면 서로 내 
부에 배치관리자창문부품들을 겹쌓을수 있다. (QWidget 는 기정적으로 배치관리자를 가 
지지 않으며 QWidget 안에서 창문부품들을 배 치하려고 한다면 그것을 추가해 야 한다.) 

• QHBox 는 수평 행 안에 있는 자식창문부품들을 왼쪽에서 오른쪽으로 배 치 한다. 


| One | Two | Three | Four | Five 


• QVBox 는 수직 렬안에 있는 자식 창문부품들을 우에 서 아래 로 배 치한다. 



• QGrid 는 자식창문부품들을 2차원살창형태로 배 치한다. 살창이 가지는 렬수를 지 
정할수 있으며 앞의 행 이 다 차면 새로운 행을 시작하면서 왼쪽에서 오른쪽으로 옮겨진 
다. 살창은 고정되고 자식창문부품들은 창문부품의 크기가 조절될 때 다른 행들로 흐르 
지 않는다. 
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우에 보여준 살창은 다음의 코드에 의해 생성될수 있다. 

QGrid *mainGrid = new QGrid ( 2 ) ； // 2 Xn 살창 

new QLabel ( " One ", mainGrid ); 

new QLabel ( " Two ", mainGrid ); 

new QLabel ( " Three ", mainGrid ); 

new QLabel ( " Four ", mainGrid ); 

new QLabel ( " Five ", mainGrid ); 

자식 창문부품들에 대 하여 QWidget： : setMinimumSizeO 혹은 

QWidget :: setFixedSize () 를 호출하여 일정 한 범위까지 배 치를 조절할수 있다. 

2. 배치관리자에 창문부품들의 추가 

배 치 관리 자에 창문부품들을 추가하는 배 치과정은 다음과 같다. 

① 모든 창문부품들은 처음에 그것들의 QWidget : : sizePolicy () 에 따라서 일정 한 
크기의 공간에 할당된다. 

② 창문부품들이 0이상의 값을 가지는 신축결수설정을 가진다면 신축곁수에 비례하 
여 공간에 할당된다 

③ 일부 창문부품들은 공간을 요구하지 않고 다른 창문부품들은 신축결수설정이 0 
이 라면 더 큰 공간을 차지한다. 이것들에 대하여 우선 크기확장정책에 따라 창문부품들 
에 공간이 할당된다. 

④ 최소크기(혹은 최소크기 가 지정되지 않으면 최소크기암시)이하의 공간이 할당되 
는 창문부품들에 는 최소크기 가 할당된다. (창문부품들은 신축결수가 그것들의 결정 인자 
(determining factor ) 인 경 우에 최 소크기 혹은 최 소크기암시 를 가지 지 말아야 한다. 

⑤ 자기 의 최 대 크기 이 상 공간에 할당되 는 창문부품들은 필요한 최 대 크기 공간에 할 
당된다. (창문부품들은 신축곁수가 자기의 결정인자인 경우에 최대크기를 가지지 말아야 
한다.) 

- 신죽결수 

창문부품들은 보통 신축곁수 (stretch factor ) 설정없이 창조된다. 그것들이 어떤 배 
치관리자안에서 배 치될 때 창문부품들은 그들의 QWidget ： ： sizePolicy () 혹은 최소크 
기암시중 큰 값에 따라서 일정한 비률의 공간에 주어진다. 신축결수들은 창문부품들에 
호상비례하여 주어지는 공간의 량을 변경하는데 쓰인다. 

신축곁 수설정없 이 QHBox 를 사용하는 3개 의 창문부품을 배 치하였 다면 다음과 같은 
배치를 얻는다. _ 


매개 창문부품에 신축곁수들을 적용한다면 그것들은 균형적으로 배치된다. (그러나 
그것들의 최소크기암시보다 절대 로 작을수 없다.) 실례 로 
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3. QLayout 의 파생클라스화 

배치 관리자를 더 조종할 필요가 있다면 QLayout 파생 클라스를 사용해야 한다. Qt 
에 포함된 배치 관리자클라스들은 QGridLayout 와 QBoxLayout 이다. 
(QHBoxLayout 와 QVBoxLayout 는 사용하기 쉽고 코드를 읽기 쉽게 하는 
QBoxLayout 의 보통파생 클라스 이 다. ) 

배 치관리자를 사용할 때 매개 자식을 그 부모창문부품과 배치관리자에 둘다 삽입 
해야 한다. (보통 구성자에서 addWidgetO 함수를 호출하여 수행한다.) 이렇게 매개 창 
문부품에 대하여 정렬 ( alignment ) ， 신축，배치와 같은 속성들을 지정하여 배치관리자 
파라메터 들을 줄수 있 다. 

다음의 코드는 우의 코드에서 두가지 개 량하여 살창을 만든다. 

QWidget *main = new QWidget ； 

// 1 X 1 살창을 만든다. 이것은 자동전개된다. 

QGridLayout *grid = new QGridLayout ( main , 1， 1 ) ； 

// (행，렬) 주소화로 처음 4개 창문부품을 추가한다. 
grid -> addWidget ( new QLabeK ’’ One ”, main ), 0, 0 )； 

grid -〉 addWidget ( new QLabeK " Two ", main ), 0, 1 ) ； 

grid -> addWidget ( new QLabeK " Three ", main ), 1, 0 ) ； 
grid -〉 addWidget ( new QLabeK ’’ Four ”, main ), 1, 1 ) ； 

// 행2，렬 0- 렬1，중심에 마지막창문부품을 추가한다. 

grid->addMultiCel 1 Widget ( new QLabeK " Five ", main )，2, 2, 0, 1, 
Qt： : AlignCenter ) ； 

// 렬 0 과 1 의 폭들사이의 비가 2:3되게 한다. 
grid -> setColStretch ( 0, 2 ) ； 
grid->setColStretch ( 1, 3 ) ； 

구성 자에 서 파라메터 로서 부모배 치관리 자를 제 공하여 배 치관리 자안에 배 치관리 자들 
을 삽입할수 있 다. 

QWidget *main = new QWidget ； 

QLineEdit *field = new QLineEditC main ) ； 

QPushButton *ok = new QPushButtonC ’’ OK ”, main ) ； 

QPushButton *cancel = new QPushButton ( " Cancel ", main ) ； 

QLabel *label = new QLabeK "Write once , compile everywhere . ,f , 
main ) ； 


// 창문부품우의 배치관리자 

QVBoxLayout *vbox = new QVBoxLayout ( main ); 
vbox->addWidget ( label ) ； 
vbox->addWidget ( field ) ； 

// 배치관리자안의 배치관리자 

QHBoxLayout ^buttons = new QHBoxLayout ( vbox ) ； 
buttons->addWidget ( ok ) ； 
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buttons->addWidget ( cancel ); 

기정배치가 만족되지 않으면 부모없이 배치관리자를 창조한 다음 addLayoutO 에 
의해 그것을 삽입한다. 그때 안쪽 배 치관리자는 삽입되는 배 치관리자의 자식으로 된다. 

4. 사용자정의배 치관리 자 

기본배치관리자콜라스들이 충분하지 않으면 자체로 정의할수 있다. 자기의 배치관 
리자클라스를 순환하는 QGLayoutlterator 의 파생콜라스는 물론 크기를 조절하고 크기 
를 계산하는 QLayout 의 파생들라스를 만들어 야 한다. 

5. 배 치 관리 자안의 사용자정 의 창문부품 

또한 자체의 창문부품콜라스를 만들 때 그의 배치관리자속성들과 교제해야 한다. 창문 
부품이 QLayout 를 가진다면 이것은 이미 고려된다. 창문부품에 자식창문부품이 없거나 
수동배치관리자를 사용한다면 다음과 같은 QWidget 성원함수들을 재정의해야 한다. 

• QWidget :: sizeHint () 는요구되는 창문부품의 크기를 돌려준다. 

• QWidget : : minimumSizeHint () 는창문부품이 가질수 있는 최소크기를 돌려준다. 

• QWidget : : sizePolicy () 는창문부품의 공간요구를 서 술하는 값인 QSizePolicy 를 
돌려 준다. 

크기 암시，최소크기 암시 혹은 크기정 책 이 변할 때 QWidget： : updateGeometryO 
를 호출한다. 이것은 배치를 다시 하게 한다. updateGeometry 0에 대한 다중호출은 
오직 한번 재계산하게 한다. 

요구되는 창문부품의 높이 가 그 실제 너 비(실례로 자동단어중지를 가지는 표식)에 
의존한다면 sizePolicyO 의 hasHeightForWid 比 i () 기발을 설정하고 

QWidget :: heightForWidth 0 를 재 정 의 한다. 

heightForWidth 0를 재정의하여도 아직 좋은 sizeHintO 를 제공할 필요가 있다. 
sizeHintO 는 창문부품이 요구하는 폭을 제공하며 그것은 heightForWidth 0를 지원하 
지 않는 QLayout 파생클라스 ( QGridLayout 와 QBoxLayout 는 그것을 지원한다.)에서 
사용된다 

이 함수들의 실현에 대 한 자세한 차림 표는 자기 의 새 창문부품에 대 하여 류사한 배 
치요구를 가지는 현존 Qt 들라스들에서 그 실현방법을 참고하시오. 

6. 수동배치관리자 

일 종의 특수배 치관리 자를 만들고있 다면 우에 서 술한 사용자정 의창문부품을 만들수 
도 있다. QWidget :: resizeE vent 0 를 재정의하여 필요한 크기분배량을 계산하고 매개 
자식에 대하여 setGeometryO 를 호출한다. 

창문부품은 배치를 재계산해야 할 때 LayoutHint 형의 사건을 얻는다. 

QWidget :: eventO 를 재정의 하여 LayoutHint 사건들에 대하여 통지 한다. 

7. 배치문제 

표식자창문부품에서 리치본문의 사용은 그 부모창문부품의 배치에 문제를 일으킬수 
있 다. 표식 자에 서 단어 의 일부가 가리 울 때 리치 본문을 Qt 의 배 치 관리 기 가 조종하는것 
으로 인하여 문제 가 발생 한다. 일정 한 경우에 부모배 치관리 자는 

QLayout : :FreeResize 방식 으로 넣 어지는데 이것은 작은 크기의 창문들에 맞게 내용의 
배치를 받아들이지 않거나 사용자가 창문을 사용할수 없을 정도로 너무 작게 만드는것을 
방지한다는것을 의미한다. 이것은 문제를 일으킨 창문부품들의 파생콜라스를 만들고 적 
당한 sizeHintO 와 minimumSizeHintO 함수들을재정의 하여 극복할수 있다. 
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제 2 절. 자체의 배치관리기작성 

여기서는 하나의 실례를 구체적으로 제시한다. 클라스 CardLayout 는 같은 이름의 
Java 배치관리기에 받아들일수 있다. 그것은 항목들(창문부품이나 겹쌓인 배치관리자들) 
을 서로의 우에 배치한다. 이때 매개 항목은 QLayout : : spacing () 만큼씩 변위된다. 
자체의 배치관리자클라스를 쓰려면 다음과 같이 정의해야 한다. 

배치관리자에 의해 조절된 항목들을 보관하는 자료구조. 매개 항목은 
QLayoutltem 이다. 실례에서 QPtrList 를 사용한다. 

• addltemO , 배치관리자에 항목들을 추가한다. 

• setGeometry (), 배치를 진행 한다. 

• sizeHintO , 배 치 관리 자의 등록된 크기 . 

• iterator () , 배 치 관리 자에 대 하여 반복한다. 

대부분의 경우에 minimumSizeO 도 실현한다. 

(1) card.h 
#ifndef CARD.H 
#define CARD_H 

#include < qlayout . h > 

#include < qptrlist . h > 

class CardLayout : public QLayout 

{ 

public ： 

CardLayout ( QWidget * parent , int dist ) : QLayout ( parent , 0, dist ) {} 
CardLayout ( QLayout * parent , int dist ) : QLayout ( parent , dist ) { } 
CardLayout ( int dist ) : QLayout ( dist ) {} 

^CardLayout () ； 

void addltem (QLayoutltem * item ) ； 

QSize sizeHintO const ； 

QSize minimumSizeO const ； 

QLayoutlterator iterator () ； 

void setGeometry (const QRect & rect ) ； 

private : 

QPtrList < QLayoutItem > list ； 

}； 

#endif 

(2) card.cpp 
■elude ” card , h ” 

우선 배 치 관리 자에 대 한 반복자를 정 의 한다. 배 치 관리 자반복자는 창문부품삭제 를 
조절하기 위 하여 배 치체계 에서 내적 으로 쓰인다. 또한 그것은 응용프로그람작성 자들이 
사용할수 있다. 

두개의 다른 클라스들을 포함한다. QLayoutlterator 는 응용프로그람작성자들이 
볼수 있는 클라스로서 명시적으로 공유된다. QLayoutlterator 는 모든 작업을 수행하는 
QGLayoutlterator 를 포함한다. 배치관리자클라스를 반복하는 방법을 알고있는 
QGLayoutlterator 의 파생 클라스를 창조해 야 한다. 

이 경우에는 간단한 실현을 선택한다. 즉 목록에서의 옹근수첨수와 목록의 
지적자를 보관한다. QGLayoutlterator 의 매개 파생클라스는 구성자와 함께 
current 0와 nextO , taieCurrentO 를 실현해야 한다. 실례에서는 해체과를 요구하지 
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않는다. 

class CardLayoutlterator : public QGLayoutlterator 

{ 

public ： 

CardLayoutlterator ( QPtrList < QLayoutItem > *1 ) : idx ( 0 )， list ( 1 ) {} 
QLayoutltem * current () { return idx < int ( list -〉 count 0) ? list - 
> at ( idx ) : 0； } 

QLayoutltem * next () { idx ++； return current () ； } 

QLayoutltem * takeCurrent () { return list -〉 take ( idx ) ； } 

private : 
int idx ； 

QPtrList < QLayoutItem > * list ; 

}； 

이 배치관리자에 대하여 QLayoutlterator 를 돌려주도록 QLayout : iterator () 를 
실현해야 한다. 

QLayoutlterator CardLayout :: iterator () 

{ 

return QLayoutlterator ( new CardLayoutlterator (& list ) ) ； 

} 

addltemO 은 배치관리자항목들에 대한 기정배치전략을 실현한다. 이것은 
QLayout :: add () 에 의하여, 배치관리자를 부모로 가지는 QLayout 구성자에 의하여 
사용되며 자동추가기능을 실현하는데 쓰인다. 자기의 배치관리자가 파라메터들을 
요구하는 고급한 배치선택을 가지고있으면 QGridLayout :: addMultiCell () 와 같은 
여분의 호출함수를 제공해 야 한다. 

void CardLayout ： : addltem ( QLayoutltem *item ) 

{ 

list , append ( item ) ； 

} 

배치관리자는 추가된 항목들의 응답능력을 물려받는다. QLayoutltem 가 
QObject 를 계승하지 않으므로 항목들을 수동적으로 삭제해야 한다. 함수 
QLayout : : deleteAllItems () 는 배 치관리 자안의 모든 항목들을 삭제 하기 위 하여 우에서 
정 의 한 복사구성 자를 사용한다. 

CardLayout ： 卜 CardLayout 0 

{ 

deleteAllltemsO ； 

} 

setGeometryO 함수는 실제로 배치를 수행한다. 인수로서 주어진 직4각형은 
marginO 을 포함하지 않는다. 적절하다면 항목들사이의 거리로서 spacingO 을 사용한다. 
void CardLayout ： : setGeometry ( const QRect 技 rect ) 

{ 

QLayout ： : setGeometry ( rect ) ； 

QPtrListIterator < QLayoutItem > it ( list ) ； 
if ( it . count 0 == 0) 
return ； 

QLayoutltem * item ; 
int i = 0； 

int w = rect . width () - ( list . count () - 1 ) * spacingO ; 
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int h = rect . height () - ( list , count () - 1 ) * spacing () ； 


while ( (item = it . current ()) != 0 ) { 

++ it ; 

QRect geom ( rect.xO + i * spacing (), rect.yO + i * spacing (), w , h )； 
item->setGeometry ( geom ) ； 

++ i ； 


sizeHintO 와 minimumSizeO 는 보통 실현에서 서로 비슷하다. 두 함수가 돌려준 
크기들은 marginO 이 아니라 spacingO 을 포함해야 한다. 

QSize CardLayout： : sizeHintO const 

{ 

QSize s ( 0, 0 )； 
int n = list , count () ； 
if ( n > 0 ) 

s = QSize ( 100, 70 ) ； // start with a nice default size 
QPtrListIterator < QLayoutItem > it ( list ) ； 

QLayoutltem * item ; 

while ( (item = it . current ()) != 0 ) { 

++ it ; 

s = s . expandedTo ( item -〉 minimumSizeO ) ； 

} 

return s + n * QSize ( spacingO , spacingO ); 


QSize CardLayout ： ：minimumSizeO const 

{ 

QSize s ( 0, 0 )； 

int n = list , count () ； 

QPtrListIterator < QLayoutItem > it ( list ) ； 

QLayoutltem 

while ( (item = it . current ()) != 0 ) { 

++ it ; 

s = s . expandedTo ( item -〉 minimumSizeO ) ； 

} 

return s + n * QSize ( spacingO , spacingO ) ； 

} 

(3) 알아두어 야 할것 

이 배치관리자는 heightForWidthO 를 실현하지 않는다. 

우리는 QLayoutltem :: isEmpty () 를 무시한다. 이것은 은폐된 창문부품들을 볼수 
있는것 으로 취 급한다는것 을 의 미 한다. 

복잡한 배치에서 속도는 계산값들을 고속완충함으로써 크게 증가될수 있다. 그 
경우에 QLayoutltem : : invalidated 를 실현하여 고속완충된 자료를 불결한것으로서 
표식 한다. 

QLayoutltem： : sizeHintO 등의 호출은 비 용이 들수 있으므로 같은 함수에서 
후에 다시 요구되는 값은 국부변수에 보관하여야 한다. 

같은 함수에서 같은 항목에 대 하여 QLayoutltem : : setGeometry () 를 두번 
호출하지 말아야 한다. 항목이 여러개의 자식창문부품을 가지면 매번 완전배치를 
수행해야 하므로 거기에 비용이 매우 많이 든다. 그대신에 기하학적도형을 계산하여 
설정한다. (이것은 배치관리자에만 제한되지 않고 자체의 resizeEventO 를 실현하는 
경우에도 같은 조작을 수행해 야 한다.) 
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제 3 절. 자리표계 

Qt 의 그리기장치는 그림을 그릴수 있는 2차원평면이다. QWidget 와 QPixmap , 
QPicture , QPrinter 는 모두 그리기장치이다. QPainter 는 그러한 장치우에 그릴수 있 
는 객체이다. 

그리기장치의 기정자리표계는 왼쪽웃구석에 자기 원점 이 있다. 표는 오른쪽으로 증 
가하고 구는 아래로 증가한다. 단위는 화소에 기초하는 장치에서 1화소이고 인쇄기에서 
lpoint 이 다. 

1. 실례 

그림 5-1 은 그리 기장치 의 왼쪽웃구석 을 크게 확대한 부분을 보여 준다. 


0 1 2 3 4 5 G 7 8 9 



그림 5-1. 자리표계 

직4각형과 직선은 다음의 코드에 의하여 (격자와 설명에서 준 색을 추가하여) 그려 
진 다. 

void My Widget :: paintE vent ( QPaintEvent * ) 

{ 

QPainter p ( this ); 
p . setPen ( darkGray ); 
p.drawRect( 1,2, 5,4 ); 
p.setPen( lightGray); 
p.drawLine( 9,2, 7,7); 

} 

drawRectO 에서 그리는 모든 화소는 지정된 크기 (5 X 4 화소)안에 있다. 이것은 일 
부 도구들에 서 는 다르다. Qt 에 서 사용자가 지 정 하는 크기 는 그려 진 화소들을 정 확히 둘 
러싼다. 이것은 QPainter 의 관련한 모든 함수들에 적용된다. 

마찬가지로 drawLineO 호출은 직선의 량끝점을 그린다. 

표 5-1 에 자리표계와 가장 밀접히 련관된 콜라스들을 보여준다. 

자리표계관련클라스 


표 5-1. 
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QPoint 

자리표계에서 하나의 2차원점. Qt 에서 점들을 취급하는 대부분 
의 함수는 하나의 QPoint 인수 혹은 2개의 int 를 받아들일수 있다. 

실 례 로 QPainter :: drawPoint 0 . 

QSize 

하나의 2차원백토르. 내부적으로 QPoint 와 QSize 는 같지만 점 
과 크기는 다르므로 두개의 클라스가 존재한다. 또한 대다수 함수들 
은 하나의 QSize 혹은 2개의 int 를 받아들인다. 실례로 
QWidget :: resize (). 

QRect 

2차원직4각형. 대부분의 함수들은 하나의 QRect 혹은 4개의 
int 를 받아들인다. 실례 로 QWidget :: setGeometry (). 

QRegion 

임의의 점들의 모임으로서 모든 표준연산모임 실례로 

QRegion ： intersect 0 또한 공용체 나 령 역 ( region ) 과 같은 직4 
각형들의 목록을 돌려주는 적은 량의 일반함수를 포함한다. QRegi 
on 은 례 하면 QPainter : : setClipRegion () 와 QWidget :: repaint 
0, QPaintEvent :: region 0에 의하여 사용된다. 

QPainter 

그리기하는 콜라스. 같은 코드로 어떤 장치에 그릴수 있다. 장 
치들사이 에 차이 가 있다. QPrinter : : newPage () 가 좋은 실례 이지 
만 QPainter 는 모든 장치 에서 같은 방식 으로 작업 한다. 

QPaintDevice 

QPainter 가 그릴수 있는 장치 . 두개의 내부장치(둘다 화소에 
기초)와 두개의 외부장치 QPrinter 와 QPicture ( QPainter 지령들 
을 파일이나 다른 QiODevice 에 기록하고 그것들을 되살린다.)가 
있 다. 다른 장치 도 정 의할수 있 다. 


2. 변환 

어의 기정자리표계가 우에 서술한것처럼 작업한다하더라도 QPainter 는 또한 임의 
의 변환도 유지한다. 

첫 단계에서는 세계 ( world ) 변환행렬을 사용하여 자기 모형 에서 객체들의 방향을 
맞추고 위치를 지정한다. Qt 는 이 행렬에 대하여 조작하도록 하기 위하여 
QPainter : : rotate 0， QPainter ： ： scale (), QPainter ： : translate () 등 메 쏘드들을 제 
공한다. 

QPainter : : save 0와 QPainter : : restore 0는 이 행렬을 보관하고 되살린다. 또한 
QWMatrix 객체들과 QPainter ： : worldMatrixO , QPainter : : setWorldMatrix () 를 사 
용하여 이름있는 행렬을 보관하고 리용한다. 

둘째 단계에서는 창문을 사용한다. 창문 ( window ) 은 모형자리표계의 보기경계를 
서술한다. 행렬은 객체들의 위치를 정하고 QPainter :: set Window 0는 자리표계에서 
보이는 창문의 위치를 정한다. 

셋째 단계는 보기구역 ( viewport ) 을 사용한다. 보기구역 역시 보기경계를 서술하지만 
장치자리표계 이 다. 보기구역과 창문은 같은 직4각형을 서술하지만 자리표계 가 다르다. 

화면에서 기정은 사용자가 그리고있는 전체 QWidget 혹은 QPixmap 이다. 

그러므로 그려지는 각 객체는 QPainter : : worldMatrix () 에 의 하여 모형 자리표계 
로 변환된 다음 QPainter : : window 0와 QPainter : : viewport 0 에 의 하여 그리 기 장치 
상의 위치가 정해진다. 

하나 또는 두개의 단계없이 수행 할수도 있다. 실례로 자기 목적 이 어떤 비례 로 확 
장하여 그리는것 이 라면 QPainter : : scale 0를 리 용하는것 이 옳다. 자기 목적 이 고정 크 
기 자리 표계 를 사용하는것 이 라면 QPainter： : setWindowO 가 리 상적 이 다. 

여기에 3개의 기구를 모두 사용하는 간단한 실례가 있다. 시계를 그리는 함수는 
aclock / aclock . cpp 실례 에 있다. 더 읽 기 전에 실례 를 를파일하고 실행할것 을 권고한다. 
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특히 창문을 각이한 크기로 조절해보시오. 

void AnalogClock ： : drawClock ( QPainter *paint ) 

{ 

paint->save 0 : 

우선 인쇄기의 상태를 보관하여 호출하는 함수가 우리 가 사용하려는 변환에 의하여 
혼돈하지 않도록 담보할수 있다. 

paint->setWindow ( -500,-500，1000,1000 ); 

모형자리표계를 1000 X 1000 창문으로 설정한다. 여기서 중심은 0,0이다. 

QRect v = paint->viewport () : 

int d = QMIN ( v . width (), v . height 0 ); 

우리가 시계를 요구하고 장치는 바른4각형이 아니므로 현재의 보기구역을 찾고 그 
최소의 변을 계산한다. 

paint -> setViewport ( v.leftO + ( v . width ()- d )/2, v.topO + ( v . height ()- 
d )/2, d , d )； 

그다음 낡은것의 중심에 있는 새로운 바론4각형 보기구역을 설정한다. 

이제 는 보기 에서 수행한다. 현시점 에서 0,0주위의 1000 X 1000 구역 에서 그릴 때 우 
리 가 그리는것은 출력장치 에 알맞는 최대 로 가능한 바른4각형안에 표시된다. 

그리기를 시작한다. 

QPointArray pts ； 
pts 는 점 들을 보관하는 일시 변수이 다. 

다음에 3개의 그리기블로크, 하나는 시침，다른 하나는 분침, 끝으로 문자판을 그 
린다. 우선 시침을 그린다. 
paint -> save () : 

paint -> rotate ( 30*( time . hour ()%12-3) + time . minute ()/2 ); 

그리기장치 ( painter ) 를 보관하고 그것을 회전하여 한개 축이 시침을 가리키게 한다. 
pts . setPoints ( 4, -20, 0, 0,-20, 300,0, 0,20 ); 

paint->drawConvexPolygon ( pts ); 

pts 를 4 각형 으로 설정 하여 시 침 이 3시 를 가리 키 도록 그린 다. 회 전에 의 하여 그려 지 는것 은 
오른쪽방향을 가리 킨 다. 

paint -> restore () : 

보관된 그리기장치를 복귀하여 회전을 취소시 킨다. 또한 rotate ( -30 )를 호출할수 
있지만 둥그리기오유가 발생 할수 있으므로 saveO 와 restoreO 를 사용하는것이 좋다. 
다음에 거의 갈은 방법으로 분침을 그린다. 
paint -> save () : 

paint-〉rotate ( ( time , minute ()-15) *6 ); 
pts . setPoints ( 4, -10,0, 0,-10, 400,0, 0,10 ); 
paint->drawConvexPolygon ( pts ) ； 
paint-〉restoreO : 

유일한 차이는 회전각을 계산하는 방법과 다각형의 모양이다. 

마지막으로 그려야 할것은 시계의 문자판이다. 
for ( int i =0； i <12； i ++ ) { 
paint -> drawLine ( 440,0, 460,0 ); 
paint -〉 rotate ( 30 ); 

} 

12 개의 짧은 시 간선이 30도간격 으로 되 여있다. 그 끝에서 그리 기 객체 가 아주 비효 
과적인 방법으로 회전되지만 그리지 않으므로 문제 가 생기지 않는다. 


186 




paint -> restore () : 


g0ometry().x() geometryQ 



의로 I 령 역 


width() and geometryQ .widthQ 


fra meGeometryO .widthO 
그림 5-2. 창문구조 

1. Unix/Xll 특성 

Unix / Xll 에서 창문은 창문관리기가 창문을 장식할 때까지 틀을 가지지 않는다. 
이것은 showO 를 호출하여 창문이 받아들이는 첫 그리기사건후에 바로 어느한 시점에 
서 비동기적으로 발생한다. 혹은 전혀 발생하지 않는다. XII 가 유연하므로 창문이 얻는 
장식틀에 대한 안전한 가설을 만들수 없다. 

더우기 개 발도구는 화면우에 창문들을 단순히 배 치할수 없다. Qt 가 해 야 할 일은 
창문관리기에 일정한 암시를 보내는것이다. 개별적인 프로쎄스인 창문관리기는 그 암시 
를 따르거나 무시 하거나 오해 할수 있 다. 부분적으로 명백 하지 않은 ICCCM ( Inter - 
Client Communication Conventions Manual ) 으로 인하여 창문배치는 현존창문관리 


함수의 마지막 행은 그리기객체를 되살리므로 호출자는 우리가 수행한 모든 변환의 
영향을 받지 않는다. 

제4절. 창문기하 

QWidget 는 창문부품의 기하를 취급하는 여러개의 함수들을 제공한다(표 5-2). 그 
일부 함수들은 순수의뢰령역(즉 창문틀을 제외한 창문)에 대하여 조작하며 다른 함수들 
은 창문틀에 대하여 조작한다. 변이는 가장 일반적인 사용법을 투명하게 포함하는 방법 
으로 수행된다. 


표 5-2. __ 창문기 하함수 


창문틀의 포함 

x (), y (), frameGeometry (), posO 그리고 moveO 

창문틀의 제외 

geometry (), width (), height (), rect () 그리고 size () 


제일 웃준위의 장식된 창문부품들에 대해서만 차이가 커진다. 모든 자식창문부품들 
에 대하여 틀 ( frame ) 기하는 창문부품의 의뢰기기하와 같다. 

그림 5-2 는 사용하는 함수들의 대부분을 설명한다. 

yO geometry 0 .y() 

xO I 메 ” 

r— - 1 


참문제 1 


Igls 육 OAJqeluoooeEBII 


0 IM 6 i- 0 A 41 oe 6 pueSM6I9M 
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기들에서 완전히 다르게 처리된다. 

XII 은 창문이 장식 되 면 틀기하를 엄 는 간단한 방법 을 제 공한다. Qt 는 오늘날 존 
재 하는 넓 은 범위의 창문관리 기들에서 작업하는 계 발규칙과 코드에 의 해 이 문제를 해 결 
한다. 

XII 은 창문을 최대화하는 방법을 제공하지 않는다. 그러므로 Qt 의 
showMaximizedO 함수는 그 특성을 모의해야 한다. 결과는 frameGeometryO 의 결과와 
창문관리기가 적 당한 창문배 치를 수행 하는 능력에 의존하며 그 어느것도 담보될수 없다. 

2. 창문기하의 복귀 

현대응용프로그람들의 공통과제는 후의 쎄숀에서 창문기하를 되살리는것이다. 
Windows 에서는 geometry 0의 결과를 기본적으로 보관하고 다음 쎄손에서 showO 를 
호출하기전에 setGeometryO 를 호출한다. XII 에서는 보이지 않는 창문이 아직 틀을 
가지지 않으므로 작업하지 않는다. 창문관리기는 후에 창문을 장식하군 한다. 이 런 일이 
발생할 때 창문은 장식틀의 크기에 따라 화면의 오른쪽아래구석으로 옳긴다. 표는 리론 
적으로 이러한 옮기기를 피하는 방법을 제공한다. 그럼에도 불구하고 거의 모든 창문관 
리기들이 이 기능을 실현하는데서 실패한다. 

그 대책은 showO 후에 setGeometry 0를 호출하는것이다. 이것은 두가지 결함이 
있다. 즉 창문부품이 1 ms 동안 잘못된 위치에 나타나고(섬광이 생긴다) 현재는 오직 매 
개의 둘째 창문관리기가 그것을 바로 잡는다. 더 안전한 해결책은 pos () 와 size 0를 둘 
다 보관하고 showO 를 호출하기전에 resizeO 와 moveO 를 리용하여 기하를 회복하는 
것이다. 그것을 다음의 실례에서 보여준다. 

MyWidget * widget = new MyWidget 

QPoint p = widget->pos 0 ; // 위 치 보관 

QSize s = widget -> size (); // 크기 보관 

widget = new MyWidget : 
widget -〉 resize ( s ); // 크기회복 

widget->move ( p ) ； // 위 치 회 복 

widget -> show () : // 창문부품표시 

이 방법은 MS-Windows 와 대부분의 현존 XII 창문관리기들에서 작업한다. 
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제 6 장. 모듈 

Qt 를 설치할 때 일정한 모둘들이 서고에 구축된다. Qt Professional 판에서는 기본 
모둘 즉 도구，핵심，창문부품, 대화칸, 그림기호보기 그러고 작업공간모둘을 사용할수 
있다. 현재 Trolltech 는 개별적으로 판매하기 위한 모둘을 제공하지 않는다. 

각 판과 련관된 사용허가하에서만 모든 모둘을 사용할수 있다. 


제1절. 캔버스모듈 

캔버스(그림천)모둘은 QCanvas 라고 부르는 고도로 최적화된 2차원도형처리령역을 
제공한다. 캔버스는 임의의 개수의 QCanvasItem 을 포함할수 있다. 캔버스항목들은 임 
의의 모양과 크기, 내용을 가질수 있으며 캔버스안에서 자유로 이동할수 있으며 충돌을 
검사할수 있다. 캔버스항목들은 자동적으로 캔버스를 질러가도록 설정될수 있으며 동화 
캔버스항목들은 QCanvasSprite 에 의해 유지된다 . (3 차원도형처 리를 요구한다면 어의 
◦penGL 모둘을 참고.) 

캔버스모둘은 문서-보기모형을 사용한다. QCanvas View 둘라스는 캔버스의 특수한 
보기를 표시하는데 리용된다. 다중보기는 같은 캔버스에 대하여 동시에 조작할수 있다. 
매개 보기는 확대와 같은 기능을 간단히 실현하게 하는 임의의 전송행렬을 캔버스에서 
사용할수 있다. 



그림 6-1 . 캔버스모듈 

Qt 는 다음과 같이 미리 정의된 QCanvas 항목들을 많이 제공한다. 
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• QCanvasItem -모든 캔버스항목들의 추상기초클라스. 

• QCanvasEllipse - 타원 혹은 부채 형 . 

• QCanvasLine - 선분. 

• QCanvasPolygon - 다각형 . 

• QCanvasPolygonalltem - 비 직 4각형 모양을 가지는 항목들의 기초클라스. 대부 
분의 캔버스항목들은 이 클라스에서 파생된다. 

• QCanvasRectangle - 직 4각형 . 직 4각형은 타일 모양으로 하거 나 또는 회전시 킬 
수 없다. 회전된 직4각형은 QCanvasPolygon 을 리용하여 그린다. 

• QCanvasSpline - 다중베쎌 스프라인. 

• QCanvasSprite - 동화픽 스매 프. 

• QCanvasText 一 본문문자렬 . 

두개 클라스 QCanvasPixmap 와 QCanvasPixmapArray 는 QCanvasSprite 에 의 
해 사용되며 캔버스에 살아서 움직이는 픽스매프를 표시한다. 

더 전문화된 항목들을 캔버스항목클라스들중의 하나로부터 계승에 의해 창조할수 
있다. 직접 QCanvasItem 를 계승하기보다 QCanvasItem 의 파생클라스들중의 하나(보 
통 QCanvasPolygonalltem ) 로부터 계승하는것 이 가장 간단하다. 

(QCanvas 능력을 보여주는 실례로서 examples/canvas 를 참고하시오.) 

제2절. IconView 모듈 

그림 기 호보기 모둘은 QlconView 라고 부르는 강력 한 시 각화창문부품을 제 공한다. 
API 와 기능에서 QlconView 는 QListView , QListBox 와 밀접 히 련관되 여있다. 그것 
은 사용자가 선택, 끌기，이름변경，삭제 등을 할수 있는 표식이 있는 픽스매프항목들을 
마음대로 포함한다._ 


I 그 ^ 

[item I I Item 2 Item 3 Item 4 Item 5 Item 6 

一. B 一’ ■ 

Item 7 Item 8 


그림 6-2 . 그림기호보기모듈 

제3절. 망모들 

1. 소개 

망모둘은 망프로그람을 쉽게 작성하고 이식할수 있게 하기 위한 클라스들을 제공한 
다. 본질적으로 세 부류의 클라스들이 있는데 첫째는 QSocket , QServerSocket , 
QDns 등과 같은 저수준콜라스들로서 TCP/IP 소케트를 가지고 이식가능한 방식으로 작 
업할수 있게 한다. 또한 Qt 기 초서고에 는 망규약실 현을 위한 추상층을 제 공하는 
QNetworkProtocol , QNetworkOperation 과 같은 클라스들과 이러한 망규약상에서 
조작하는 QUrlOperator 가 있다. 끝으로 셋째 부류의 망클라스들은 이전의 클라스들로 
서 특히 URL 문법해석과 그와 류사한 일을 하는 QUrl 과 QUrllnfo 이 있다. 
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첫째 부류의 콜라스들 ( QSocket ， QServerSocket , QDns , QFtp , 등)은 이의 
《망》모둘에 포함된다. 

QSocket 들라스들은 QNetwork 클라스들과 직접 련관되지 않지만 QSocket 는 직접 
련관되 여있으며 QNetwork 들라스들과 직 접 련관되 는 망규약을 실현하는데 사용된다. 
실례로 QFtp 들라스 ( FTP 규약을 실현)는 QSocket 를 사용한다. 그러나 QSocket 를 통 
신규약실 현에 사용할 필요가 없다. 실례 로 QLocalFs (망통신규약으로서 국부파일 체 계 의 
실현)는 QDir 를 사용하며 QSocket 를 사용하지 않는다. QNetworkProtocol 을 사용하 
여 계층구조에 적합한 모든것을 실현할수 있고 URL 을 사용하여 호출할수 있다. 이것은 
실례 로 직 렬련결을 리 용하여 수자식카메 라로부터 그림 을 읽어 들일수 있는 통신규약이 다. 

2. QUrlOperator 와 QNetworkOperation 을 리용하여 독립적인 망통 
신규약작성 

현존망통신규약실현을 사용하는것 과 URL 에 대 하여 조작하는것 은 아주 간단하다. 
실례 로 FTP 봉사기로부터 국부파일체계 에 로 파일의 내 리적재는 다음의 코드로 수행할수 
있 다. 

QUrlOperator op ； 

op . copy ( " ftp : / / ftp . trolltech . com / qt / source / qt -2. 1 . 0 . tar . gz " ， 

" file ：/ tmp ", FALSE )； 

물론 FTP 통신규약의 실현은 그것을 수행하는데 사용할수 있고 등록되 여 야 한다. 

또한 등록부창조，파일삭제，이름변경과 같은것들을 수행할수 있다. 실례로 자기의 
FTP 등록자리 ( account ) 에서 폴더 를 다음과 같이 창조한다. 

QUrlOperator 

op ( " ftp :// username : password 通 host . domain .); 

op . mkdir ( "New Directory " ); 

(모든 유효조작은 QUrlOperator 콜라스문서를 참고하시오.) 

망작업은 비동기적으로 진행되므로 어떤 조작을 요구하는 함수호출은 보통 그 조작 
이 끝나기전에 되돌아온다. 이것은 그 함수가 실패나 성공을 가리키는 값을 돌려줄수 없 
다는것을 의미한다. 대신에 돌림값은 항상 QNetworkOperation 의 지적자이며 이 객체 
는 그 조작에 대 한 모든 정보를 보관한다. 

실례로 QNetworkOperation 은 이 조작의 상태를 돌려주는 메쏘드를 가전다. 이것 
을 리용하여 임의의 순간에 그 조작의 상태를 알아볼수 있다. 또한 그 객체는 
QUrlOperator 메쏘드에 넘어온 인수들과 조작의 형，기타 정보를 사용할수 있게 한다 
( QNetworkOperation 클라스문서를 참고). 

QUrlOperator 는 조작의 진행정형을 알리고 신호를 발생한다. QUrlOperator 의 
URL 에 대 하여 조작하는 많은 메쏘드들을 호출할수 있으므로 그 조작들은 모두 대기렬 
에 넣는다. 그러므로 QUrlOperator 가 방금 어떤 조작을 처리했는지 알수 없다. 어느 
조작이 발생되였는가를 꼭 알아야 하므로 매개 신호의 마지막 인수는 방금 처리되여 신 
호를 발생 한 QNetworkOpera 吐 on 객체의 지적 자로 한다. 

이러한 조작의 일부는 startO 신호를 보내며 (만일 이것이 의미를 가진다면) 그 일 
부는 처리과정에 신호들을 보낸다. 모든 조작은 그것이 수행된 후에 finishedO 신호를 
보낸다. finishedO 신호와 함께 얻어지는 QNetworkOpera 仕 on 지적자를 사용하여 어떤 
조작이 성공적으로 끝났는가를 알아볼수 있다. QNetworkOperation : : state 0가 
QNetworkProtocol : : StDone 와 같으면 조작이 성 공적 으로 끝난것 이 고 그것 이 
QNetworkProtocol :: StFailed 이 면 조작은 실패 한것 이 다. 

실례 : QUrlOperator ： : finished ( QNetworkOperation * ) 에 련결할수 있는 처리부 

void MyClass ： : slotOperationFinished ( QNetworkOperation *op ) 
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{ 

switch ( op->operation() ) { 
case QNetworkProtocol ： ： OpMkDir ： 
if ( op->state() == QNetworkProtocol :: StFailed ) 
qDebug( ’’Couldn’t create directory %s", op->arg( 0 ). latinlO ) ； 
else 

qDebug( "Successfully created directory %s M , op- 
>arg( 0 ). latinlO ) ； 
break ； 

"... and so on 

} 

} 

앞에서 언급한것처럼 일부 조작은 다른 신호들도 보낸다. 실례로 자식목록조작을 
고찰하자. (FTP 봉사기에서 등록부를 읽어들인다.) 

QUrlOperator op; 


MyClass： : MyClassO : QObjectO , op ( ’’ ftp :// ftp . trolltech . com ’，) 

{ 

connect ( & op , SIGNAL ( 

newChildren ( const QValueList < QUrlInfo > &, QNetworkOperation * ) ), 
this , SLOT (slotlnsertEntries (const 
QValueList < QUrllnfo>&,QNetworkOperation *))); 
connect ( & op , SIGNAL ( start ( QNetworkOperation * ) ), 
this , SLOT ( slotStart ( QNetworkOperation *) ) ); 
connect ( 技 op , SIGNAL ( finished ( QNetworkOperation * ) ), 
this , SLOT ( slotFinished ( QNetworkOperation *) ) ); 


void MyClass ： : slotlnsertEntries ( c»nst QValueList < QUrlInfo >& info , QNelworkOpemtion *) 

{ 

QValueList < QUrlInfo > :: Constlterator it = info , begin (); 
for ( ; it != info , end () ； ++it ) { 
const QUrllnfo &inf = * it ; 

qDebug ( " Name : % s , Size ： % d , Last Modified ： % s ", 
inf . name 0. latinl (), inf . size 0, 

inf . lastModified 0. toString (). latinl () ) ； 

} 


void MyClass ： ： slotStart( QNetworkOperation * ) 

{ 

qDebugC "Start reading op. toString(). latinl () ) ； 


void MyClass ： ： slotFinished( QNetworkOperation ^operation ) 

{ 
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if ( operation->operation () == QNetworkProtocol : ：OpListChildren ) { 
if ( operation->state() == QNetworkProtocol： : StFailed ) 
qDebugC ’’Couldn’t read ’%s’! Following error occurred ： %s M , 
op. toStringO. latinl (), operation->protocolDetail (). latinl () ) ； 

else 

qDebugC "Finished reading op. toStringO. latinl () ) ； 



이 실례들은 QUrlOperator 와 QNetworkOperation 의 사용법을 보여준다. 또한 
망확장은 쓸모있는 실례코드를 포함한다. 

1) 자체의 망통신규약의 실현 

QNetworkProtocc)l 은 망통신규약을 실현하기 위한 기초클라스와 망통신규약의 동 
적인 등록과 등록해제를 위한 구성방식을 제공한다. 이 구성방식을 사용하면 비동기적프 
로그람작성에 대하여 관심을 두지 않아도 된다. 그것은 구성방식에 이것이 은페되여있고 
그것 이 모든 작업을 수행하기때문이다. 

알아두기: 모든 망통신규약들에서 사용할수 있는 망통신규약용 기초클라스를 설계 
하는것은 힘들다. 여기에 서술한 구성방식은 파일체계와 갈은 모든 종류의 계층구조에서 
작업하도록 설계된다. 그러므로 계층구조로서 해석할수 있고 URL 을 거처서 호출할수 
있는 모든것은 망통신규약으로 실현될수 있으며 Qt 에서 간단히 사용할수 있다. 이것은 
파일체계에만 국한되지 않는다. 

망통신규약을 실현하려면 QNetworkProtocol 로부터 파생된 클라스를 창조한다. 

다른 클라스들은 이 망통신규약실현을 사용하여 조작한다. 그러므로 다음의 보호성 
원들을 재정의하여야 한다. 

void QNetworkProtocol : ： operationListChildren( QNetworkOperation *op ) ； 
void QNetworkProtocol : ： operationMkDir( QNetworkOperation *op ) ； 
void QNetworkProtocol : ： operationRemove( QNetworkOperation *op ) ； 
void QNetworkProtocol : ： operationRename( QNetworkOperation *op ) ； 
void QNetworkProtocol ： ： operationGet( QNetworkOperation *op ) ； 
void QNetworkProtocol ： ： operationPut( QNetworkOperation *op ) ； 

이 메쏘드들의 재정의에 대한 몇가지 알아두기: 인수로서는 항상 
QNetworkOperation 의 지적자를 얻는다. 이 지적자는 현재 상태에서 조작에 대한 모 
든 정보를 보유한다. 그와 갈은 조작을 처리하기 시작하면 상태를 
QNetworkProtocol : : StlnProgress 로 설정 한다. 조작에 대 한 처 리 가 끝나면 그것 이 
성 공하였 을 때 상태 를 QNetworkProtocol : : StDone 으로 설 정 하고 오유가 발생 하면 
QNetworkProtocol::StFailed 로 설정한다. 오유가 발생하였으면 오유코드를 설정해야 
하며 (QNetworkOperation : : setErrorCode 0 참고) 자세 한것 (실 례 로 오유통보) 을 알려 
면 이 통보를 조작지적자로 설정할수도 있다. 

(QNetworkOperation :: setProtocolDetail 0 참고. ) 또한 QNetworkOperation 지 적 자 
로부터 조작에 대한 모든 관련정보(형，인수 등)를 얻는다. (어떤 인수들을 얻고 설정할 
수 있는가에 대하여 자세히 알려면 QNetworkOperation 의 클라스문서를 참고하시오.) 

어떤 조작함수를 재정의한다면 정확한 시간에 정확한 신호를 발생하는것이 아주 중요하 
다. 일반적으로 조작의 마감에 (성공적으로 조작처리를 끝냈거나 오유가 발생하였을 때) 인 
수로서 망조작을 가지는 finishedO 를 항상 발생한다. 전체 망구성방식은 정확히 발생된 
finishedO 신호에 기초한다. 그때 조작들에 고유한 좀 더 전문화된 신호들이 있다. 

• operationListChildren 에 서 발생 하는것 : 
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start () : 자식들의 렬거를 시작하기 바로전에 
newChildrenO : 새 자식들을 읽어들일 때 

• operationMkDir 에 서 발생 하는것 : 
createdDirectory () : 등록부를 창조한 후에 

newChildO (혹은 newChildrenO ) : 등록부를 창조한 후에 (새 등록부가 새 자 
식이므로) 

• operationRemove 에 서 발생 하는것 : 
removed 0 : 자식이 삭제된 후에 

• operationRename 에 서 발생 하는것 : 
itemChangedO : 자식의 이름이 변경된 후에 

• operationGet 에 서 발생 하는것 : 
dataO : 새 자료를 읽어들였을 때마다 

dataTransferProgress () : 새 자료를 읽어들였을 때마다 현재 읽어들인 자료량을 
보여 준다. 

• operationPut 에 서 발생 하는것 : 

dataTransferProgress () : 자료를 써넣었을 때마다 써넣은 자료량을 보여준다. 
비록 이 조작이 호출될 때 모든 자료를 알고있어도 한번에 전체 자료를 쓰지 않고 GUI 
가 봉쇄 되 는것 을 피 하기 위 하여 한걸 음씩 수행할것 을 제 안한다. 또한 증분적 으로 수행 하 
는 수법은 그 진척과정을 사용자가 시각적으로 볼수 있게 한다. 

그리고 마감에 항상 finishedO 신호를 발생 한다 ( QNetworkProtocol 클라스문서 참고). 
여기에 어떤 QNetworkOperation 인수들을 얻을수 있으며 어느 함수에서 어떤 인 
수들을 설정하여 야 하는가 하는 목록이 있다. (자기가 작업하여야 할 URL 을 얻으러면 
URL 연산자의 지적 자를 돌려주는 QNetworkProtocol : : url () 메쏘드를 사용한다. 그것 
을 사용하여 경로，주를퓨터，이름려과기 등을 얻을수 있다.) 

• operationListChildren 에 서 
없다. 

• operationMkDir 에 서 

QNetworkOperation ： ： arg ( 0 ) 은 창조하려 는 등록부의 이 름을 포함한다. 

• operationRemove 에 서 

QNetworkOperation ： ： arg ( 0 ) 은 삭제 하려는 파일의 이름을 포함한다. 보통 이 
것은 상대적인 이름이다. 그러나 절대적일수도 있다. QUrl ( op - 
> arg ( 0 ) ). fileName () 을 사용하여 파일이름을 엄는다. 

• operationRename 에 서 

QNetworkOperation :: arg ( 0 ) 은 변경하려는 파일의 이름을 포함한다. 
QNetworkOperation ： : arg ( 1 ) 은 변경된 이름을 포함한다. 

• operationGet 에 서 

QNetworkOperation ： ： arg ( 0 ) 은 검색 하여 야 할 파일의 완전 URL 을 포함한다. 

• operationPut 에 서 

QNetworkOperation ： : arg ( 0 ) 은 자료가 보관되는 파일의 완전 URL 을 포함한다. 
QNetworkOperation :: rawArg ( 1 ) 은 QNetworkOperation :: arg ( 0 ) 안에 보 
관될 자료를 포함한다. 

요약: 하나의 조작함수를 재정의한다면 여러개의 특수신호들을 발생해야 하며 마지 
막에는 성공했는가 실패했는가에 관계없이 항상 finishedO 신호를 발생해야 한다. 또한 
처리과정에 QNetworkOperation 의 상태를 변경하여야 한다. 또한 조작이 진행될 때 
QNetworkOperation 인수들을 얻거 나 설정할수 있다. 

자기가 실현하는 망통신규약이 이 조작들의 부분모임만을 요구하는 경우도 있을수 
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있다. 그러한 경우에 간단히 통신규약에 의하여 제공되는 조작들을 재정의한다. 또한 자 
기가 지원하는 조작들을 지정해야 한다. 이것은 재정의에 의하여 달성된다. 
int QNetworkProtocol :: supportedOperations () const ； 

이 메쏘드의 실현에서는 다음과 같은 QNetworkProtocol 의 렬거값들(지원된 조작 
들)의 론리합으로 구성되는 int 값을 돌려주어 야 한다. 

• OpListChildren 

• OpMkDir 

• OpRemove 

• OpRename 

• OpGet 

• OpPut 

실례로 자기의 통신규약이 자식들의 목록화와 그 이름변경을 지원한다면 자기의 
supportedOperations 0를 다음과 같이 실현하여야 한다. 
return OpListChildren | OpRename ； 

재정의해야 할 마지막 메쏘드는 다음과 같다. 
bool QNetworkProtocol :: checkConnection ( QNetworkOperation *op ) ； 

여기서 련결이 성공하면 TRUE 를 돌려주어야 한다. (이것은 통신규약에 대한 조작 
이 진행될수 있다는것을 의미한다.) 련결이 실패하면 FALSE 를 돌려주고 다시 련결을 
열려고 시도한다. 끝까지 련결을 열수 없으면 (실례로 주를퓨터를 찾지 못하여) 
finished 0 신호를 발생 하고 QNetworkProtocol :: StFailed 상태 를 여 기 서 얻 어 지 는 
QNetworkOperation 지 적자로 설정 한다. 

련결이 성공하면 조작을 하기전에 자체로 검사할 필요가 없다. 망구성방식이 바로 
이것을 수행 하는데 그것은 checkConnectionO 을 리용하여 어떤 조작을 수행할수 있는 
가를 확인하며 수행할수 없으면 일정한 시간동안 그것을 다시 시도하고 련결이 성공하면 
조작함수를 호줄할뿐이다. 

QUrlOperator (그밖에 실례로 QFileDialog 에서 망통신규약을 사용하게 하려면 망 
통신규약실현을 등록하여 야 한다. 이것은 다음과 같이 수행할수 있다. 

QNetworkProtocol :: registerNetworkProtocol ( ’’ myprot " , new 

QNetworkProtocolFactory < MyProtocol > ) ； 

이 경우에 MyProtocc)l 은 여기서 서술한것처럼 실현한 클라스 
( QNetworkProtocol 에서 파생)이며 통신규약의 이름은 " myprot ” 이다. 그것을 사용하 
려면 다음과 같이 해 야 한다. 

QUrlOperator op ( M myprot : / / host / path " ); 
op . listChildrenO ； 

끝으로 망통신규약실현의 실례로서 QLocalFs 의 실현을 볼수 있다. 또한 망확장은 
망통신규약의 실례실현을 포함한다. 

2) 오유조종 

오유조종은 새로운 망통신규약의 실현이나 그 사용 ( QUrlOperator 을 통하여)에서 
모두 중요하다. 

조작의 처리에서 망조작을 끝낸 후에 QUrlOperator 는 finishedO 신호를 발생한다. 
이것은 처리된 QNetworkOperation 의 지적자를 인수로 가전다. 조작의 상태가 
QNetworkProtocol :: StFailed 이면 조작은 오유에 대한 정보를 더 포함한다. 표 6-1 의 
오유코드들은 QNetworkProtocol 에 서 정 의 되 여있 다. 
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의미 I 


ᅳ-、 

QNetworkProtocol :: ErrValid 

조작하고있는 URL 이 무효이다. 

QNetworkProtocol :: ErrUnknow 
n Protocol 

조작중에 있는 0 RL 의 통신규약에 사용 
할수 있는 통신규약실현이 없다. (실례로 
통신규약이 http 이고 http 실현이 등록되 
지 않은 경우에) 

QNetworkProtocol :: ErrUnsuppo 
rted 

조작이 통신규약에 의해 지원되지 않는 
다. 

QNetworkProtocol :: ErrParse 

URL 의 오유를 해 석한다. 

QNetworkProtocol :: ErrLoginlnc 
orrect 

가입 ( login ) 이 요구되지만 사용자이름이 
나 암호가 틀린다. 

QNetworkProtocol :: ErrHostNot 
Found 

URL 에서 지정된 주름퓨터를 찾을수 없 
다. 

QNetworkProtocol :: ErrListChil 
dren 

자식 들을 목록할 때 오유가 발생하였 다. 

QNetworkProtocol :: ErrMkDir 

등록부를 창조하는동안 오유가 발생하였 
다. 

QNetworkProtocol :: ErrRemove 

자식 을 삭제 하는데 오유가 발생하였 다. 

QNetworkProtocol :: ErrRename 

자식 의 이 름을 변경할 때 오유가 발생하 
였 다. 

QNetworkProtocol :: ErrGet 

자료를 얻 을 때 (검 색할 때 ) 오유가 발생 
하였다. 

QNetworkProtocol :: ErrPut 

자료를 넣 을 때(올리 적재할 때 ) 오유가 
발생 하였 다. 

QNetworkProtocol :: ErrFileNotE 
xisting 

조작에 의 해 요구되 는 파일 이 존재 하지 
않는다. 

QNetworkProtocol :: ErrPermissi 
onDenied 

조작수행 에 대 한 허가가 금지되 였다. 


QNetworkOperation : : errorCode () 는 이 코드들중 하나를 돌려 준다. 오유- 
추가적으로 정 의 하는 자체 의 망통신규약실현을 사용한다면 다른것 을 돌려 준다. 

또한 QNetworkOperation :: protocolDetails 0는 사용자에 게 현시 하는데 
오유통보를 포함하는 문자렬을 돌려줄수도 있다. 

자체의 망통신규약을 실현한다면 발생한 오유를 통보하여야 한다. 우선 그 
처리중에 있는 QNetworkOperation 에 늘 접근할수 있어야 한다. 이것은 현재 
의 지적자를 돌려주거나 그 순간에 아무런 조작도 처리되지 않는다면 0을 돌 
QNetworkOperation :: operationlnProgress () 에 의 해 수행 된 다. 

오유가 발생하고 오유를 조종할 필요가 있다면 다음과 같이 한다. 
if ( operationlnProgress () ) { 

operationlnProgress 0 - >setErrorCode ( error _ code _ of _ your_error 
operationlnProgress ()->setProtocolDetails ( detail ) ； // optional 
emit finished ( operationlnProgress () ) ； 




QUrlOperator 에 대 한 련결 등은 자동적 으로 수행 된다. 또한 현재 상태 에 서 수행 할 
수 있는 조작이 더는 없으므로 실지 오유가 치명적인것이라면(실례로 주를퓨터를 찾을수 
없 다면 ) finished 0 를 발생 하기 전 에 QNetworkProtocol :: clearOperationStack () 를 
호줄한다. 

리상적으로 QNetworkProtocol 의 미리 정의된 오유코드들중의 하나를 사용해야 
한다. 이것이 불가능하면 자체의 오유코드를 추가할수 있는데 그것들은 보통의 int 값들 
이다. 오유코드의 값이 현존오유코드와 충돌하지 않도록 주의하여야 한다. 

qt / examples / network/ftpclient 에 실례가 있다. 이것은 상당히 완성된 FTP 의 
퇴기의 실현으로서 파일의 내리적재와 올리적재, 등록부만들기 등을 지원하며 
QUrlOperator 에 의 하여 모든것이 수행된다. 

또한 QFtp ( qt / src / network / qftp . cpp 에 서 ) 혹은 

qt / examples / network / networkprotocol / nntp.cpp 의 실례를 고찰할수도 있다. 

제4절. Qt OpenGL 3차원도형처리 

◦penGL 은 3차원도형을 그리기 위한 표준 API 이 다. 

OpenGL 은 오직 3차원그리 기 만을 처 리 하며 GUI 프로그람작성 문제 는 거 의 제 공하지 
않는다. OpenGL 응용프로그람의 사용자대 면부는 X 가동환경 에서 Motif , Windows 에 서 
MFC , 혹은 두 가동환경 에서 Qt 와 같은 도구묶음에 의해 창조되 여 야 한다. 

Qt OpenGL 모둘은 Qt 응용프로그람에서 OpenGL 을 간단히 사용할수 있게 한다. 
이것은 다른 Qt 창문부품들처럼 사용할수 있는 OpenGL 창문부품클라스들을 제공한다. 
그러나 그것은 OpenGL API 에 의하여 내용을 그릴수 있는 OpenGL 현시완충기를 열수 
없다. 

Qt OpenGL 모둘은 가동환경 에 의 존하는 GLX , WGL 혹은 AGL C API 들에서 가 
동환경에 의존하지 않는 Qt 八:++래퍼로서 실현된다. 제공된 기능은 Mark Kilgard 의 
GLUT 서고와 아주 비슷하지만 OpenGL 에 훨씬 더 고유하지 않은 보다 많은 GUI 기능 
즉 완전한 Qt API 를 가진다. 


1. 설치 

XII 에 이를 설치할 때 configure 스크립트는 OpenGL 머리부와 서고들이 자기 체 
계에 설치되는가 자동탐색하며 그렇다면 Qt 서고안에 있는 Qt OpenGL 모둘을 포함한다. 
(자기의 OpenGL 머리부나 서고들이 비표준등록부에 배치된다면 자기 체계의 config 파 
일 안에 있는 QMAKE _ INCDIR_OPENGL 이 나 QMAKE _ LIBDIR_OPENGL 을 변경할 
필요가 있다). 일부 환경설정은 OpenGL 에 스레드화가 허 i 될것을 요구하므로 OpenGL 
이 탐지 되 지 않으면 configure - 仕 iread 를 실 행 한다. 

Windows 에 Qt # 설치할 때 Qt OpenGL 모둘이 늘 포함된다. 

Qt OpenGL 모둘은 Qt Proffes 성 ional 판에서 사용하는것이 허용되지 않는다. 
OpenGL 지원을 요구한다면 Qt Enterprise 판으로의 갱신을 고려해 야 한다. 

XII 에서 Mesa 의 사용에 대한 알아두기: 3.1 판이 전의 Mesa 는 서고들에 GL 과 
GLU 대신에 MesaGL 와 MesaGLU 라는 이름을 사용한다. 3.1 이전판의 Mesa 를 사용하 
려면 이러한 서고이름을 사용하도록 Makefile 들을 변경해야 한다. 가장 간단한 방법은 
사용하고있는 config 파일 안의 QMAKE _ LIBS_OPENGL 행 을 편집 하는것 이 며 즉 "-1 GL 
-1 GLU " 를 "-IMesaGL -1 MesaGLU "5. 변경균 다음 configure 를 다시 실행하는것 이 다. 
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2. QGL 클라스들 

어에서 OpenGL 지원콜라스들은 다음과 같다. 

• QGLWidget ： OpenGL 장면들을 그리는데 사용하기 쉬운 Qt 창문부품. 

• QGLContext ： OpenGL 그리기 상황을 은폐 한다. 

• QGLFormat ： 그리기상황의 현시형식을 지정한다. 

• QGLColormap ： GL 첨 수방식 에서 색 인화된 색 략도를 조종한다. 

수많은 응용프로그람들은 높은수준의 QGLWidget 클라스만 요구한다. 다른 QGL 콜 
라스들은 고급한 기능을 제공한다. 

QGL 문서는 OpenGL 프로그람작성법을 잘 알고있는것을 전제로 한다. 그것이 처음 
이라면 http :// www . opengl . org / 이 출발점으로 된다. 


제5절. SQL 모듈 

Qt 의 SQL 콜라스들은 다음과 같다. 

QSql , QSqlCursor , QSqlDatabase , QSqlDriver , QSqlDriverPlugin , QSqlEditorFactory , 

QSqlEnor , QSqMeld , QSqMeldlnfo , QSqlForm , QSqllndex , QSqlPropertyMap , 

QSqlQuery , QSqlRecoid , QSqlRecordlnfo , QSqlResult , QSqlSelectCursor 

이 상의 SQL 콜라스들은 Qt 응용프로그람들에 대 한 원만한 자료기 지 통합을 제 공한다. 

이 절에서는 적 어도 SQL 에 대 한 기초지식을 가지고 있다고 가정한다. 간단한 
SELECT , INSERT , UPDATE , DELETE 지 령 들을 리 해 하고 있 어 야 한다. 비 록 
QSqlCursor 클라스가 SQL 에 대한 지식을 요구하지 않는 자료기지열람과 편집을 위한 
대면부를 제공하여도 SQL 에 대한 기초적인 리해가 상당히 요구된다. ( SQL 자료기지를 
설명하는 표준원서 는 참고문헌 [幻 이다. ) 

이 모둘개괄은 순수 프로그람적견지에서 콜라스를 제시 하며 한편 《 Qt 프로그람개 발 
도구》에 서 1 장 7절 은 창문부품들사이 의 주-세 부관계 의 설 정，구멍 내 기 처 리 , 외 부열 쇠 
탐색조종방법과 갈은 높은 수준의 수법들을 보여준다. 

이 절의 모든 실례는 소절 8에서 정의된 표들을 사용한다. 


1. SQL 모듈구성방식 

SQL 클라스들은 3개의 층으로 구성된다. 즉 

① 사용자대면부층. 이 클라스들은 자료원천으로 QSqlCursor 를 사용함으로써 자료 
기 지안에 있는 표나 보기 들에 련결 할수 있는 자료인식 창문부품들을 제 공한다. 말단사용 
자들은 이 창문부품들과 직 접 교제하여 자료를 열 람하거 나 편집할수 있 다. Qt 
Designer 는 SQL 클라스들과 완전히 통합될수 있고 자료를 인식하는 폼을 창조하는데 
사용될수 있다. 또한 자료인식창문부품들은 C ++ 코드로 직접 프로그람작성할수 있다. 이 
층을 유지하는 클라스들은 QSqlEditorFactory , QSqlForm , QSqlPropertyMap , 
QDataTable , QDataBrowser 및 QDataView 를 포함한다. 

② SQL API 층. 이 콜라스들은 자료기지에 대한 접근을 제공한다. 련결은 
QSqlDatabase 들라스에 의해 이 루어 진 다. 자료기 지 교제 는 QSqlQuery 콜라스를 사용하 
여 SQL 지 령 들을 직 접 실 행하거 나 SQL 지 령 들을 자동적 으로 구성 하는 고수준 
QSqlCursor 콜라스에 의하여 이루어진다. QSqlDatabase , QSqlCursor 및 
QSqlQuery 와 함께 SQL API 층은 QSqlError , QSqlField , QSqlFieldlnfo , 
QSqllndex , QSqlRecord 및 QSqlRecordlnfo 에 의 하여 지 원된다. 

③ 구동프로그람층. 이것은 3개의 클라스 QSqlResult , QSqlDriver 및 
QSqlDriverFactorylnterface 로 구성된다. 이 층은 자료기지와 SQL 들라스들사이의 
저수준다리 를 제 공한다. 이 층은 구동프로그람작성 자와만 관련되 여있고 표준자료기 지응 
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용프로그람작성 에 는 거 의 사용되 지 않으므로 따로따로 문서 화된 다. 

2. SQL 구동프로그람플라그인들 

Qt SQL 모둘은 풀라그인들을 사용하여 실행시에 새 구동프로그람들을 동적으로 적 
재할수 있다. 

SQL 구동프로그람문서는 특정한 자료기지관리 체 계를 위한 플라그인구축방법 을 서 술 
한다. 

플라그인이 일단 구축되면 Qt 는 자동적으로 그것을 적재하여 구동프로그람을 
QSqlDatabase 에 의 하여 사용할수 있 다 ( QSqlDatabase : : drivers 0 참고) . 

3. 자료기지와 련결 

QSqlQuery 혹은 QSqlCursor 클라스들을 사용하기전에 적어도 하나의 자료기지 
련결이 창조되 여 열려져 있어 야 한다. 

응용프로그람이 하나의 자료기 지련결 만 요구한다면 QSqlDatabase 들라스는 모든 
SQL 조작들에 대 하여 기정 적 으로 사용되는 련결을 창조할수 있다. 만일 다중자료기지련 
결 이 요구된다면 이것을 쉽 게 설정할수 있다. 

QSqlDatabase 은 qsqldatabase.h 머 리 부파일을 요구한다. 

1) 단일자료기지와 련결 

자료기지련결의 창조는 간단한 3단계의 과정 즉 구동프로그람을 능동상태 로 만들기 , 
련결정보의 설정, 그리고 련결의 열기로 이루어진다. 

// sql/overview/connect 1/ main, cpp 로부터 
#include <qapplication.h> 

#include <qsqldatabase. h> 

#include ".. /connection, h" 

int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv, FALSE ); 

QSqlDatabase *defaultDB = 

QSqlDatabase ： ： addDatabase( DB_SALES_DRIVER ) ； 

defaultDB->setDatabaseName ( DB_SALES_DBNAME ); 
defaultDB->setUserName ( DB_SALES_USER ); 
defaultDB->setPassword( DB_SALES_PASSWD )； 
defaultDB->setHostName ( DB_SALES_HOST )； 

if ( defaultDB->open () ) { 

// Database successfully opened ； we can now issue SQL 
commands. 


return 0； 

} 

첫째 로， QSqlDatabase : : addDatabase () 를 호출하여 구동프로그람을 능동상태 로 
만들고 이 련결에 사용하려는 구동프로그람의 이름을 넘긴다. 사용할수 있는 구동프로그 
람들로서 는 QODBC 3 (Open Database Connectivity , Microsoft SQL Server 지원을 
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포함)， QOCI8 (Oracle 8과 9), QTDS7 (Sybase Adaptive Server), 
QPSQL7(PostgreSQL 6 과 7), QMYSQL3 (MySQL), QDB2(IBM DB2), 
QSQLITE(SQLite) 및 QIBASE(Interbase) 가 있다. 이 구동프로그람들중에서 일부 
는 Qt Open Source 판에 포함되여있지 않다. 

창조되는 련결은 응용프로그람의 기정 자료기지련결로 되며 다른 자료기지 가 지정되 
지 않았으면 Qt SQL 클라스들에 의하여 사용된다. 

둘째로， setDatabaseNameO , setUserNameO, setPasswordO 그리고 
setHostNameO 을 호출하여 련결정보를 초기화한다. QOCI8 (Oracle 8과 9) 구동프로 
그람에서는 TNS 봉사이름을 setDatbaseNameO 에 넘겨야 한다. ODBC 자료원천에 련결 
할 때 자료원천이름 (DSN) 을 setDatabaseNameO 호출에 사용하여야 한다. 

셋째로， openO 함수를 호출하여 자료기지를 열고 자료에 대한 호출을 준다. 이 호 
출이 실패하면 FALSE 를 돌려주며 오유정보는 QSqlDatabase::lastError() 로부터 얻 
을수 있다. 


2) 여려 자료기지와 련결 

여러 자료기지와의 련결은 둘째 인수가 련결을 구분하는 유일한 식별자인 
QSqlDatabase::addDatabase() 함수의 2인수형식을 사용하여 달성할수 있다. 

다음의 실례에서 자체의 함수 createConnectionsO 에로 련결들을 옮기고 몇가지 
기초적인 오유조종을 추가하였다. 

#define DB_SALES_DRIVER "QPSQL7" 

#define DB_SALES_DBNAME "sales" 

#define DB_SALES_USER "salesperson" 


#define DB_SALES_PASSWD "salesperson" 

#define DB_SALES_HOST "database, domain, no" 


#define DB_ORDERS_DRIVER "QOCI8" 

#define DB_ORDERS_DBNAME "orders" 

#define DB_ORDERS_USER "orderperson" 

#define DB_ORDERS_PASSWD "orderperson" 
#define DB_ORDERS_HOST "database, domain, no" 


bool createConnections 0; 

connec 仕 on.h 에서 몇가지 상수들을 설정하고 createConnectionsO 함수를 선언한다. 
// sql/overview/connection, cpp 로부터 
#include <qsqldatabase. h> 

■elude "connection, h" 


bool createConnections 0 


QSqlDatabase *defaultDB = QSqlDatabase： : addDatabase( DB_SALES_DRIVER ) : 
defaultDB->setDatabaseName( DB_SALES_DBNAME ); 
defaultDB->setUserName ( DB_SALES_USER ); 
defaultDB->setPassword( DB_SALES_PASSWD )； 
defaultDB->setHostName ( DB_SALES_HOST ) : 
if ( ! defaultDB->open () ) { 

qWaming( "Failed to open sales database： " + defaultDB->lastError0.textO )； 
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return FALSE ； 


} 

QSqlDatabase ^tBcle = QSqlDatabase ： : addDatabase( DBjORDERS 一 DRIVER, 
"ORACLE ，，)； 

oracle->setDatabaseName ( DB_ORDERS_DBNAME ); 
orac 1 e->setUserName ( DB_ORDERS_USER ); 
oracle->setPassword ( DB_ORDERS_PASSWD ) ； 
oracle->setHostName ( DB_ORDERS_HOST ); 
if ( ! oracle->open() ) { 

qWaming( "Failed to open orders database ： ’’ + oiBcle->lastError().textO )； 
return FALSE ； 

} 

QSqlQuery q(QString ： : null, defaultDB) ； 

q. exec (” create table people (id integer primary key, name char(4 ①) 

q. exec (” create table staff (id int^er primary key, forename char(40)，" 

"surname char(40), salary float, statusid integer)”); 
q. exec ("create table status (id integer primary key, name char (30))") ； 
q. exec ("create table creditors (id integer primary key, forename 
char(40), ’’ "surname char (40), city char (30) ) M ) ； 

q. exec ("create table prices (id integer primary key, name char (40), 
price float) ’’) ； 

q. exec ("create table invoiceitem (id integer primary key, ’’ 

’’pricesid integer, quantity integer, paiddate date) ’’) ； 


QSqlQuery q2(QString ： : null, oracle) ； 

q2. exec ("create table people (id integer primary key, name 
char (40) ) n )； 

return TRUE ； 

} 

connection.cpp 의 createConnections() 함수에서 자료기지련결을 분리시키도록 
선택 하였다 . 

// sql/overview/create_connections/main, cpp 로부터 
#include <qapplication. h> 

#include <qsqldatabase. h> 

#include ".. /connection, h” 


int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv, FALSE ) ； 
if ( createConnections () ) { 

// Databases successfully opened ； get pointers to them ： 
QSqlDatabase *oracledb = QSqlDatabase ： : database( ’’ORACLE” ) ； 
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// Now we can now issue SQL commands to the oracle 
connection 

// or to the default connection 

} 

return 0 ； 

} 

정적함수 QSqlDatabase:: database 0 는 자료기지련결의 지적자를 제공하는곳이라 
면 어 디서 나 호출할수 있다 . 파라메터없이 그것을 호출하면 기정 련결을 돌려준다 . 련결 
에 사용된 식별자(가령 우의 실례에서 ’’ORACLE ") 를 가지고 호출되면 지정된 련결의 
지 적자를 돌려 준다 . 

Qt Designer 에 의해 main.cpp 를 창조한다면 그것은 실례와 같은 
createConnections 0 함수를 포함하지 않는다 . 이것은 Qt Designer 안에서 보여주는 
응용프로그람들에 자체의 자료기지련결함수를 실현하지 않으면 실행 되지 않는다는것 을 
의 미 한다 . 

우의 코드에서 ODBC 련결이 명명되지 않았으므로 기정련결로서 사용된다 . 
QSqlDatabase 는 addDatabaseO 정적 함수에 의하여 되돌아온 지적자들의 소유권을관리 
한다 . 관리하는 련결목록에서 자료기지를 삭제하기 위하여서는 

QSqlDatabase: : close 0 에 의하여 자료기지를 닫고 정적함수 

QSqlDatabase :: removeDatabase 0 에 의 해 그것 을 삭제 한다 . 

4. QSqlQuery 을 리용한 SQL 지 령의 실행 

QSqlQuery 콜라스는 SQL 지 령 들을 실 행 하기 위한 대 면부를 제 공한다 . 또한 
SELECT 질문들의 결과모임 을 항행하기 위한 함수들과 개 별적 인 레 코드들과 마당값들을 
검 색 하기 위한 함수들을 가전 다 . 

다음 소절에서 서술하는 QSqlCursor 클라스는 QSqlQuery 로부터 계승되고 SQL 
지령들을 구성하는 고수준 대면부를 제공한다 . QSdlCursor 는 특히 화면우의 창문부품 
들과 통합하기 쉽다 . SQL 을 모르는 프로그람작성자들은 이 소절을 안전하게 뛰여 넘어 
QSqlCursor 콜라스를 사용할수 있다 . 

1) 일괄처리 

기 초하고있는 자료기 지 엔진 이 일 괄처 리 (transaction ) 를 지 원한다면 

QSqlDriver: :hasFeature(QSqlDriver: : Transactions ) 는 TRUE 를 돌려 준다 . 
QSqlDatabase: transaction 0 에 의해 일괄처리를 초기화할수 있다 . 이때 일괄처리문 
맥 안에 실행 하려 는 SQL 지 령들을 따라보낸다 . 그다음 QSqlDatabase: : commit 0 나 
QSqlDatabase ： : rollback () 를 실 행 한다 . 

2) 기본열람 

// sql/overview/basicbrowsing/main.cpp 로부터 

#include <qapplication. h> 

#include <qsqldatabase. h> 

#include <qsqlquery.h> 

#include ".. /connection, h" 


int main( int argc, char *argv [] ) 

{ 

QApplication app( argc, argv, FALSE ); 
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if ( createConnections () ) { 

QSqlDatabase *oracledb = QSqlDatabase： : database( ’’ORACLE” ) ； 
// oracle 자료기지에서 ODBC ( 기정)자료기지로 자료를 복사한다 . 
QSqlQuery target； 

QSqlQuery query ( "SELECT id, name FROM people", oracledb ) ； 
if ( query, isActiveO ) { 
while ( query, next() ) { 

target, exec( "INSERT INTO people ( id, name ) VALUES ( ,f + 
query.value(0).toStringO +’’， ’’’ + query.value(l).toStringO + 



return 0 ； 

} 

우의 실례에서는 머리부파일 qsqlquery.h 를 추가하였다 . 창조한 첫 질문 target 는 
기정자료기지를 사용하며 처음에는 비여있다 . 둘째 질문 다에서 레코드를 검색하려는 
’’ORACLE ” 자료기지를 지정한다 . 두 자료기지련결은 모두 앞에서 제시 한 
createConnections 0 함수안에 서 설정 되였다 . 

처음의 SELECT 문을 창조한 다음에 질문이 성공적으로 실행되였는가를 확인하기 위 
하여 isActiveO 가 검사된다 . next 0 함수는 질문결과들을 순환하는데 사용된다 . 
valueO 함수는 마당들의 내용을 QVariant 로서 돌려준다 . 삽입은 target QSqlQuery 객 
체 를 사용하여 기 정 자료기 지 에 대 한 질 문들을 창조하고 실 행 함으로써 달성할수 있 다 . 

이 실례와 이 절의 다른 모든 실례들은 소절 8 에서 정의된 표들을 사용한다 . 

// sql/overview/basicbrowsing2 / main, cpp 로부터 
int count = 0 ； 
if ( query.isActiveO ) { 
while ( query, next() ) { 

target, exec( "INSERT INTO people ( id, name ) VALUES ( ，’ + 
query.value(0).toStringO + ", + query.value(1).toStringO + 

if ( target.isActiveO ) 
count += target. numRowsAffected0 ; 


우의 코드는 성과적으로 삽입된 레코드량을 소개한다 . isActiveO 는 질문(실례로 
삽입 ) 이 실패 하면 FALSE 를 돌려 준다 . numRowsAffectedO 는 행 수를 결정할수 없 으 
면 실례로 질문이 실패하면 -1 을 돌려준다 . 

3) 기본자료조작 

// sql/overview/basicdatamanip/main, cpp 로부터 
#include <qapplication. h> 

#include <qsqldatabase. h> 

#include <qsqlquery.h> 

#include ./connection.h” 


bool createConnections () ； 
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int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv, FALSE ) ； 
int rows = 0 ； 

if ( createConnections () ) { 

QSqlQuery query( "INSERT INTO staff (id, forename, surname, salary ) 
” VALUES ( 1155, ’Ginger’, ’Davis’, 50000 广 ); 
if ( query, isActiveO ) rows += query. numRowsAffected0 ； 

query.exec( ’’UPDATE staff SET salary=60000 WHERE id=1155 M )； 
if ( query, is ActiveO ) rows += query. numRows Affected 0 ； 


query.exec( ” DELETE FROM staff WHERE id=1155 M )； 
if ( query, is ActiveO ) rows += query. numRows Affected 0 ; 


return ( rows == 3 ) ? 0 ： 1 ； 

} 

이 실례는 간단한 SQL 자료조작언어 (DML,data manipulation language ) 지령들 
을 설명한다 . QSqlQuery 구성자에서 자료기지를 지정하지 않았으므로 기정자료기지가 
사용된다 . 또한 QSqlQuery 객 체 들은 CREATE TABLE, CREATE INDEX 와 같은 SQL 자 
료정 의 언어 (DDL, data definition language ) 지 령 들을 실행 하는데 사용된다 . 

4) 결과모임의 항행 

일단 SELECT 질문이 성공적으로 실행되면 질문기준에 대조되는 레코드들의 결과모 
임에 대한 접근이 가능하다 . 이미 항행함수들중의 하나인 nextO 를 사용하였다 . 이 함 
수는 레코드들에 차례로 접근하는데 독자적으로 사용될수 있다 . 또한 QSqlQuery 는 
firstO 와 lastO, prevO 를 제공한다 . 이러한 지령들다음에 isValidO 를 호출하여 유효 
레코드에 있는가 검사할수 있다 . 

또한 seekO 에 의하여 임의의 레코드에로 항행할수 있다 . 자료모임의 첫 레코드는 
령이다 . 마지막 레코드의 번호는 sizeO - 1 이다 . 모든 자료기지가 SELECT 질문의 크기 
를 제공하지 않으므로 이와 갈은 경우에 sizeO 는 -1 을 돌려준다 . 

// sql/overview/navigating/main, cpp 로부터 
if ( createConnections () ) { 

QSqlQuery query ( ’’SELECT id, name FROM people ORDER BY name" ) ； 
if ( ! query, is ActiveO ) return 1 ； // 질문실패 
int i ； 

i = query.sizeO ； // 이 실례 에서 9 개 레코드를 가진다 . i == 9. 

query, first 0; // 첫 레코드로 이 동 . 

i = query, at() ； // i == 0 

query, last0; // 마지 막 레코드로 이동 . 

i = query, at() ； // i == 8 

query, seek( query. sizeO / 2 ) ； // 중간레코드로 이 동 . 
i = query, at() ； // i == 4 
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우의 실례는 사용중에 있는 항행함수들을 보여준다 . 

모든 구동프로그람들이 sizeO 를 유지하지 않지만 그에 대하여 구동프로그람에 질 
문할수 있다 . 

QSqlDatabase* defaultDB = QSqlDatabase： : database () : 

if ( defaultDB->driver () ->hasFeature ( QSqlDriver： : Query Size ) ) { 

// QSqlQuery :: size 0 유지 

} 

else { 

// QSqlQuery :: size 0 유지 안됨 

} 

관심 을 가지 는 레 코드를 탐색하였 다면 그로부터 자료를 얻 으러 고 할수 있 다 . 

// sql 八 ) verview/retrievel/main.cpp 로부터 
if ( createConnections () ) { 

QSqlQuery query( "SELECT id, surname FROM staff" ); 

if ( query. isActiveO ) { 
while ( query, next() ) { 
qDebug( query. value(O). toStringO + ": 

” + query, value(1). toStringO ); 

} 

} 

} 

레코드모임을 차례로 순환하려고 한다면 요구되는 항행함수는 오직 nextO 뿐이 다 . 

암시 : lastQueryO 함수는 실행된 마지막 질문의 본문을 돌려준다 . 이것은 자기가 
생각하는 질문이 실행되고있는가，실제로 어느 질문이 실행되고있는가를 검사하는데 쓸 
모있다 . 

5. QSqlCursor 의 리용 

QSqlCursor 콜라스는 자체의 SQL 을 작성 하지 않고 SQL 자료기지 표나 보기에서 
레 코드를 열 람하고 편집 하기 위한 고수준대 면부를 제 공한다 . 

QSqlCursor 는 QSqlQuery 가 할수 있는 거의 모든것을 다할수 있지만 두가지 례 
외 가 있다 . 기정 적 으로 유표가 자료기지안에서 표나 보기 를 표시하므로 QSqlCursor 객 
체 들은 새 레 코드로 이 동할 때 마다 표나 보기안의 매 레 코드의 모든 마당을 검 색한다 . 
오직 몇개의 마당들만이 관련된다면 간단히 처리를 그것들로 제한하고 다른것들은 무시 
한다 . 혹은 QSqlRecord : :setGenerated () 에 의 한 마당들의 생성을 수동적으로 불가능 
하게 한다 . 또 하나의 수법은 자기가 관심을 가지는 마당들만 표시 하고 VIEW 를 창조하 
는것인데 일부 자료기지는 편집할수 있는 보기를 지원하지 않는다 . 그러므로 실제로 유 
표안의 모든 마당들을 검색하고싶지 않으면 대신에 QSqlQuery 를 사용하여 자기 요구 
에 맞게 질 문을 정 의하여 야 한다 . 표 혹은 보기 가 매 레 코드를 유일 하게 식 별 하는 1 차 
색인을 가지도록 제공하는 QSqlCursor 를 사용하여 레코드를 편집할수 있다 . 이러한 
조건이 만족되지 않으면 편집에 QSqlQuery 를 사용할 필요가 있다 . 

QSqlCursor 는 한번 에 하나의 레 코드에 대 하여 조작한다 . QSqlCursor 에 의 하여 
삽입，갱 신 , 삭제 를 실행할 때 마다 자료기지안에 있는 오직 하나의 레 코드만이 영 향을 
받는다 . 유표안의 레 코드로 항행할 때 한번에 오직 하나의 레 코드만 응용프로그람코드에 
서 사용할수 있다 . 추가적 으로 QSqlCursor 는 자료기지안의 하나의 레 코드에 변경 이 
이루어지게 하는데 쓰이는 하나의 개별적인 《 편집완충기》를 관리한다 . 편집완충기는 
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개별적인 기억공간안에서 유지되며 유표는 한개 레코드씩 움직일 때마다 변화되는《항 
행완충기〉〉의 영향을 받지 않는다 . 

QSqlCursor 객체들을 사용하기전에 우선 자료기지련결을 창조하고 그것을 열어야 
한다 . 련결은 앞의 소절 3 에서 서술하였다 . 다음의 실례들에서는 이미 제시한 
QSqlDatabase 실례에서 정의된 createConnectionsO 함수를 사용하여 련결이 창조되였 
다고 가정한다 . 

소절 6 절에서 자료인식창문부품에서 창문부품을 자료기지유표에 련결하는 방법을 보 
여준다 . 일단 유표와 자료인식창문부품에 대한 지식을 둘다 가지면 QSqlCursor 의 파 
생클라스만들기에 대하여 론의할수 있다 . 

QSqlCursor 클라스는 qsqlcursor. h 머 리 부파일을 요구한다 . 

1) 레코드검색 

// sql/overview/retrieve2 / main, cpp 로부터 
#include <qapplication. h> 

#include <qsqldatabase. h> 

#include 〈 qsqlcursor. h> 

#include ".. /connection, h” 


int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ) ； 
if ( createConnectionsO ) { 

QSqlCursor cur( "staff" ) ； // Specify the table/view name 
cur.select() ； // We’ll retrieve every record 
while ( cur. next () ) { 

qDebug( cur.value( "id" ).toString() + " + 

cur.value( ’’surname” ).toString() + ’’’’ + 
cur. value( ’’salary’’ ).toString() ); 



return 0 ； 

} 

사용하려는 표나 보기를 지정하여 QSqlCursor 객체를 창조한다 . 기정이 아닌 자료 
기지를 사용해 야 한다면 QSqlCursor 구성 자에서 그것을 지정할수 있다 . 

cur.select 0 호출에 의해 실행된 SQL 은 
SELECT staff, id, staff, forename, staff, surname, staff, salary, 
staff, statusid FROM staff 

다음으로 cur.nextO 를 사용하여 이 select 문으로부터 돌아온 레코드들을 순환한 
다 . 마당값들은 QSqlQuery 와 비슷한 방법으로 검색된다 . 그러나 value 0 와 
setValueO 에 수값첨수가 아니라 마당이름을 넘기는것은 례외 이다 . 

- 레코드의 정렬과 려과 

검색하려는 레코드들의 부분모임을 지정하기 위하여 selectO 함수에 려과기준을 넘 
길수 있다 . 돌아오는 매개 레코드는 려과기준을 만족시킨다 . (려과기는 SQL 문의 
WHERE 절에 대응된다 .) 

cur. select ( ’’id > 100” ) ； 
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이 selectO 호출은 다음의 SQL 을 실행한다 . 

SELECT staff, id, staff, forename, staff, surname, staff, salary, 
staff, statusid 

FROM staff WHERE staff, id > 100 
이것은 id 가 100 이상인 직원만 검색한다 . 

선택된 레코드들을 검색하는것과 함께 때때로 돌려준 레코드들을 배렬순위로 지정 
하여야 한다 . 이것은 정렬하려고 하는 마당 ( 들)의 이름을 포함하는 QSqllndex 객체를 
창조하고 selectO 호출에 이 객체를 넘기여 달성된다 . 

QSqlCursor cur( "staff" ) ； 

QSqllndex namelndex = cur. index( ’’surname” ) ； 

cur. select ( namelndex ); 

여기서는 하나의 마당 ’’surname" 을 가지는 QSqllndex 객체를 창조한다 . selectO 
함수를 호출할 때 색인객체를 넘기는데 색인객체는 레코드들이 staff.surname 에 의 하 
여 정렬되여 돌아와야 한다는것을 지정한다 . 색인객체의 매개 마당은 select 문의 
ORDER BY 절에서 사용된다 . 여기서 실행하는 SQL 은 다음과 같다 . 

SELECT staff, id, staff, forename, staff, surname, staff, salary, 

staff, statusid 

FROM staff ORDER BY staff, surname ASC 
레코드들의 부분모임검색을 결합하고 결과를 정렬하기는 쉽다 . 

cur. select( "staff, surname LIKE ’A%"、namelndex ) ； 

려과문자렬 (WHERE 절)과 함께 정렬하려는 QSqllndex 객체 (ORDER BY 절)을 넘 
긴다 . 이것은 다음과 갈은 문으로 수행한다 . 

SELECT staff, id, staff, forename, staff, surname, staff, salary, 

staff, statusid 

FROM staff WHERE staff, surname LIKE ’A %， ORDER BY 
staff, surname ASC 

하나이상의 마당을 정렬하려면 여러 마당을 포함하는 색인을 창조할수 있다 . 커지 
는 자모순과 작아지는 자모순은 QSqllndex : :setDescending() 에 의 하여 설정 할수 있으 
며 기정값은 커지는 자모순이다 . 

// sql/overview/order 1/ main, cpp 로부터 

QSqlCursor cur( ’’staff” ) ； 

QStringList fields = QStringListO « "surname" « ’’forename”; 
QSqllndex order = cur. index( fields ) ； 
cur. select ( order ) ； 
while ( cur. next () ) { 

여기서 정렬하려는 마당들을 포함하는 문자렬목록을 창조하는데 그것들을 차례로 
사용한다 . 그다음 이 마당들에 기초하는 QSqllndex 객체를 창조하고 끝으로 이 색인을 
리용하여 selectO 호출을 실행한다 . 이것은 다음 문으로 실행한다 . 

SELECT staff, id, staff, forename, staff, surname, staff, salary, 
staff, statusid 

FROM staff ORDER BY staff, surname ASC, staff, forename ASC 
지정된 기준과 일치하는 마당을 가지는 레코드들을 검색해야 한다면 어떤 색인에 
기초한 려과기를 창조할수 있다 . 

// sql/overview/order2 / main, cpp 로부터 
QSqlCursor cur( ’’staff” ) ； 

QStringList fields = QStringListO « "id” « ’’forename”; 
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QSqllndex order = cur. index( fields ) ； 

QSqllndex filter = cur. index( "surname" ) ； 
cur.setValue( "surname", "Bloggs" ) ； 
cur. select ( filter, order ) ； 
while ( cur. next () ) { 

이것은 다음 문을 실행한다 . 

SELECT staff, id, staff, forename, staff, surname, staff, salary, 
staff, statusid 

FROM staff WHERE staff.surname=’Bloggs’ ORDER BY staff.id ASC, 
staff, forename ASC 

QSqllndex 객체 order 는 두개의 마당 id 와 forename 을 포함하는데 그것들은 결 
과들을 순서화하는데 쓰인다 . QSqllndex 객체 filter 는 하나의 마당 surname 을 포함한 
다 . 색인이 selectO 함수에 려과기로서 넘어갈 때 려과기안의 매 마당에 대하 
여 fieldname=value 부분절 。' 창조되는데 그 마당의 현재유표값으로부터 값이 취해진다 . 
setValueO 에 의하여 사용된 값이 요구되는 값이라는것을 보증한다 . 

- 자료발취 

// sql/overview/extract/main, cpp 로부터 
QSqlCursor cur( ’’creditors” ) ； 

QStringList orderFields = QStringListO « ” surname” « "forename”; 
QSqllndex order = cur. index( orderFields ) ； 

QStringList filterFields = QStringListO « ’’surname” « ’’city”; 
QSqllndex filter = cur. index( filterFields ) ； 
cur.setValue( ’’surname", ’’Chirac” ) ； 
cur.setValue( "city", ’’Paris” ) ； 

cur. select ( filter, order ) ； 

while ( cur. next () ) { 
int id = cur. value( "id" ).toInt() ； 

QString name = cur.value( "forename" ).toString() + ’’’’ + 

cur. value( "surname" ).toString() ； 

qDebug( QString ： : number( id ) + ’’ + name ); 

} 

이 실례에서는 creditors 표에 유표를 창조하는것으로시작한다 . 두개의 QSqllndex 
객체를 창조한다 . 첫째 객체 order 는 orderFields 문자렬목록으로부터 창조된다 . 둘째 
객체 filter 는 filterFields 문자렬목록으로부터 창조된다 . 려과기에서 사용되는 두개의 
마당 surname 과 city 의 값들을 우리가 관심을 가지는 값들로 설정한다 . 이제는 
selectO 를 호출하여다음과 같은 SQL 을 생성 하고 실행 한다 . 

SELECT creditors, city, creditors, surname, creditors, forename, creditors, id 

FROM creditors 

WHERE creditors.surname = ’Chirac’ AND creditors.city = ’Paris’ 

ORDER BY creditors, surname ASC, creditors, forename ASC 

려과기마당들은 WHERE 부분에서 쓰인다 . 마당들의 값들은 그 마당들에 대한 유표 
의 현재값들로부터 얻어지고 setValueO 를 호출하여 자체로 이 값들을 설정한다 . 
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order 마당들은 ORDER BY 부분에서 쓰인다 . 

그다음 일치하는 매개 레코드(있는 경우)를 순환한다 . id 와 forename, surname 
마당들의 내용을 검색하고 그것들을 처리함수에 넘긴다 . 이 실례에서는단순히 
qDebugO 호출에 넘긴다 . 

2) 레코드조작 

표나 보기가 매 레코드를 유일하게 식별하는 1 차색인을 가지도록 제공하는 
QSqlCursor 를 사용하여 레코드를 표나 보기에서 삽입，갱신，삭제할수 있다 . 그렇지 
않으면 QSqlQuery 를 대신에 사용하여야 한다 . (모든 자료기지가 편집가능한 보기를 
지원하는것은 아니다 .) 

매 유표는 모든 편집조작들 ( 삽입 , 갱신 , 삭제)에 의하여 사용되는 내부《편집완충 
기》를 가전다 . 편집과정은 매 조작에서 같은데 관련한 완충기의 지적자를 엄고 
setValueO 를 호출하여 요구하는 값으로 완충기를 초기화하며 insert 0 나 update 0 나 
del () 을 호출하여 필요한 조작을 수행한다 . 실례로 유표를 사용하여 레코드를 삽입할 
때 primelnsertO 를 호출하여 편집완충기의 지적자를 엄은 다음 이 완충기에서 
setValueO 를 호출하여 매 개 마당값을 설정 한다 . 그다음 QSQlCursor: :insert () 를 호 
출하여 자료기지에 편집완충기의 내용을 삽입한다 . 마찬가지로 레코드를 갱신(혹은 삭 
제)할 때 편집완충기안의 마당의 값들은 자료기지의 레코드를 갱 신(혹은 삭제)하는데 사 
용된다 . 편집완충기는 유표항행함수들에 의하여 어떤 영향도 받지 않는다 . setValueO 
에 문자렬값을 넘긴다면 단일인용표는 SQL 의 특수문자이므로 그것들은 확장되여 단일 
인용표쌍으로 바권다 . 

primelnsertO 와 primeUpdateO, primeDeleteO 메쏘드들은 모두 내부편집완충기 
의 지적자를 돌려준다 . 매개 메쏘드는 되돌아가기전에 편집완충기에 대한 서로 다른 조 
작들을 잠재적으로 수행 할수 있다 . 기정적으로 QSqlCursor: : primelnsertO 는 편집 완 
충기 안의 모든 마당값들을 지 운다 (QSqlRecord: :clearValues() 참고 ) . 

QSqlCursor: : primeUpdateO 와 QSqlCursor: : primeDeleteO 는 둘다 되돌아가기전 
에 유표의 현재내용으로 편집완충기를 초기화한다 . 3 개의 함수들이 모두 가상함수이므 
로 그 동작을 재정의할수 있다 . 실례로 primelnsertO 를 재정의하여 편집완충기안의 마 
당들에 자동적으로 번호를 불인다 . 자료인 식 사용자대면부조종요소들은 련결할수 있는 
신호들(실례로 primelnsertO ) 를 발생하며 이것들은 적당한 완충기의 지적자를 넘기므 
로 파생클라스화가 필요없을수도 있다 . (파생클라스화에 대한 자세한 정보는 소절 7 을 
보고 primelnsertO 신호와의 련결에 대해서는 《 Qt 프로그람개발도구》 1 장를 보시오 .) 

유표에 대 하여 insert(), update() 혹은 del() 을 호출할 때 그것은 무효화되 고 유 
효레코드에 더는 위 치 하지 않는다 . insert(), update() 혹은 del() 을 수행 한 후에 다른 
레코드로 이동해야 한다면 순수한 selectO 호출을 만들어야 한다 . 이것은 자료기지에 대 
한 변경 이 유표에 정확하게 반영되도록 한다 . 

沒 ) 레코드삽입 

// sql/overview/insert/main, cpp 로부터 
QSqlCursor cur( "prices" 

QStringList names = 

QStringList()<<"Screwdriver"<<"Hammer"<< "Wrench" «"Saw"; 
int id = 20 ； 

for ( QStringList :: Iterator name. ■역 names, begin() : 
name != names, end0; ++name ) { 

QSqlRecord *buffer = cur. primelnsertO : 
buffer->setValue( "id", id ); 
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buffer->setValue( "name", *name ); 
buffer->setValue( "price", 100.0 + (double)id ) ； 
count += cur. insert () ； 
id ++； 

} 

이 실례에서는 prices 표에서 유표를 창조한다 . 다음으로 순환하려는 제품이름목록 
을 창조한다 . 매번 순환할 때마다 유표의 primelnsertO 메쏘드를 호출한다 . 이 메쏘드 
는 모든 마당들이 NULL 로 설정되 여있는 QSqlRecord 완충기의 지 적 자를 돌려 준다 . 
(QSqlCursor: : primelnsertO 는 가상이므로 파생클라스에 의해 전용화될수 있다 .) 다 
음에 값을 요구하는 매 마당에 대하여 setValueO 를 호출한다 . 끝으로 insertO 를 호출 
하여 레코드를 삽입한다 . insertO 호출은 삽입한 렬수를 돌려준다 . 

primelnsertO 호출로부터 QSqlRecord 객체의 지적자를 얻었다 . QSqlRecord 객체 
들은 단일레코드에 대한 자료와 레코드에 대한 메타자료를 보유할수 있다 . 실천에서 
QSqlRecord 와의 대부분의 교제는 이 실례와 다음 실례에서 보여주는것처럼 단순한 
value 0 와 setValueO 호출들로 이루어진다 . 

② 레코드의 갱신 

// sql/overview/update/main. cpp 로부터 
QSqlCursor cur( "prices" ) ； 
cur. select ( ，， id=202” ); 
if ( cur. next () ) { 

QSqlRecord *buffer = cur. primeUpdateO ； 
double price = buffer->value( "price" ).toDouble() ； 
double newprice = price * 1.05 ； 
buffer->setValue( ” price”, newprice ) ； 
cur. update () ； 

} 

이 실례는 prices 표에 유표를 창조하는것으로 시작한다 . selectO 호출에 의해 갱신 
하려는 레코드를 선택하고 nextO 호출에 의해 거기로 이동한다 . primeUpdateO 를 호 
출하여 현재 레코드의 내용으로 채워지는 완충기 에로의 QSqlRecord 지적 자를 엄는다 . 
price 마당값을 검색하고 새로운 단가를 계산하고 price 마당을 새로 계산한 값으로 설정 
한다 . 끝으로 updateO 를 호출하여 레코드를 갱신한다 . updateO 호출은 갱신된 행수를 
돌려 준다 . 

꼭같은 갱신을 여러개 실현하여야 한다면 실례로 단가목록의 매개 항목의 단가를 증 
가시키려면 QSqlQuery 을 가지는 단일한 SQL 문을 사용하는것이 더 효과있다 . 실례로 
QSqlQuery query ( ” UPDATE prices SET price = price * 1.05” ) ； 

③ 레코드의 삭제 

// sql/overview/delete/main. cpp 로부터 
QSqlCursor cur( ’’prices’’ ) ； 
cur. select ( ，， id=999，，); 
if ( cur.nextO ) { 
cur. primeDeleteO ； 
cur. del () ； 

레코드를 삭제하기 위해서는 삭제하려는 레코드를 선택하고 거기로 항행한다 . 그다 
음 primeDeleteO 를 호출하여 선택된 레코드의 주열쇠(이 실례에서 prices.id 마당)로 
유표를 설정하고 QSqlCursor::del 0 을 호출하여 그것을 삭제한다 . 

updateO 에서처럼 어떤 일반적인 기준에 따르는 다중삭제가 필요하다면 하나의 
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SQL 문을 사용하는것이 더 효과있다 . 실례로 

QSqlQuery query ( "DELETE FROM prices WHERE id >= 2450 AND id 
<= 250 ( 广 )； 

6. 자료인식창문부품 

자료인식 창문부품 (data-aware widget ) 은 Qt 사용자대 면부에 자료기 지 를 련결 하는 
간단하고 강력한 수단을 제공한다 . 자료인식창문부품을 창조하고 조작하는 가장 쉬운 방 
법은 Qt Designer 를 사용하는것이다 . 다음의 실례와 설명은 순수 프로그람적수법을 좋 
아하는 사람들에게 하나의 소개로 된다 . ( 《 Qt 프로그람개발도구》의 1 장 7 절과 거기에 
첨부한 실례들에서 추가정보를 제공한다 .) 

1) 자료인식표들 

// sql/overview/tablel/main, cpp 로부터 
#include <qapplication. h> 

#include <qsqldatabase. h> 

#include <qsqlcursor. h> 

#include <qdatatable. h> 

#include . /connection, h” 


int main( int argc, char *argv [] ) 

{ 

QApplication app( argc, argv ) ； 

if ( createConnections () ) { 

QSqlCursor staffCursor( ” staff" ) ； 

QDataTable *staffTable = new QDataTable( SstaffCursor, TRUE ); 
app. setMainWidget( staffTable ) ； 
staffTable->refresh () ； 
staffTable->show () ； 

return app. exec() ； 

} 

return 0 ； 

} 

자료인식표는 qdatatable.h 와 qsQlcursor.h 머리부파일을 요구한다 . 응용프로그람 
객체를 창조하고 createConnections 0 을 호출하여 유표를 창조한다 . 유표의 지적자를 
넘기여 QDataTable 을 창조하고 autoPopulate 기발을 TRUE 로 설정한다 . 다음으로 
QDataTable 를 기본창문부품으로 만들고 refreshO 를 호출하여 거기에 자료를 채우고 
showO 를 호출하여 표시한다 . 

autoPopulate 기발은 유표에 기초하여 렬 들을 창조하여야 하는가를 QDataTable 
에 알려준다 . autoPopulate 는 표에 자료를 적재하는데 영향을 주지 않으며 그것은 
refreshO 함수에 의하여 달성된다 . 

// sql/overview/table2 / main, cpp 로부터 
QSqlCursor staffCursor( "staff" ) ； 

QDataTable *staffTable = new QDataTable ( 技 staffCursor ) ； 
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app. setMainWidget( staffTable ) ； 


staffTable->addColumn( ’’forename”, ” Forename’，); 
staffTable->addColumn( "surname", ’’Surname” ) ； 
staffTable->addColumn( "salary", "Annual Salary" ) ； 

QStringList order = QStringListO « ’’surname” « ’’forename”; 
staffTable->setSort( order ) ； 

staffTable->refresh () ； 
staffTable->show () ； 

기본창문부품으로 만들려는 빈 QDataTable 을 창조한 다음 현시하려는 순서로 필 
요한 렬들을 수동적으로 추가한다 . 매 렬에 대하여 마당이름과 함께 선택적으로 현시표 
식을 지정 한다 . 

또한 표안의 렬들을 정렬하려고 하며 이것은 자체로 유표에 정렬을 적용함으로써 
달성된다 . 

일단 모든것이 설정되면 refresh() 를 호출하여 자료기지로부터 자료를 적재하고 
showO 를 호출하여 창문부품을 표시한다 . 

QDataTables 은 시각적인 렬들만 검색하며 이것은 아주 큰 표들을 최소기억원가로 
서 매우 고속으로 현시하게 한다 . (구동프로그람에 의존한다 .) 

2) 자료인식폼의 창조 

자료인식폼의 창조는 매 마당을 개별적으로 고찰해야 하므로 자료인식표를 사용하 
는것보다 더 복잡하다 . 아래의 대부분의 코드는 Qt Designer 에 의 하여 자동생성된다 . 

- 레코드의 현시 

// sql/overview/forml/main, cpp 로부터 
#include 〈 ^application .!!〉 

#include <qdialog. h> 

#include <qlabel.h> 

■elude <qlayout. h> 

#include <qlineedit.h> 

#include <qsqldatabase. h> 

#include <qsqlcursor. h> 

#include <qsqlform. h> 

#include ".. /connection, h” 



FormDialogO 


FormDialog： : FormDialogO 

{ 

QLabel *forenameLabel = new QLabel( "Forename:’’, this ) ； 
QLabel *forenameDisplay = new QLabel ( this ) ； 

QLabel *surnameLabel = new QLabel( ’’Surname:’’, this ) ； 
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QLabel *surnameDisplay = new QLabeK this ) ； 

QLabel *salaryLabel = new QLabel( ’’Salary:", this ) ； 

QLineEdit *salaryEdit = new QLineEditC this ) ； 

QGridLayout *grid = new QGridLayout( this ) ； 
grid - 〉 addWidget( forenameLabel, 0, 0 ) ； 

grid- 〉 addWidget( forenameDisp 1 ay, 0, 1 ) ； 

grid->addWidget( surnameLabel, 1, 0 )； 
grid->addWidget ( su rnameDisp 1 ay, 1, 1 ) ； 

grid->addWidget ( salary Label, 2, 0 ) ； 

grid->addWidget ( salary Edit, 2, 1 ) ； 

grid->activate() ； 

QSqlCursor staffCursor( ’’staff” ) ； 
staff Cursor, select () ； 
staff Cursor. nextO ； 

QSqlForm sqlForm( this ) ； 

sqlForm. setRecord( staff Cursor. primeUpdateO ) ； 
sqlForm. insert( forenameDisplay, "forename" ) ； 
sqlForm. insert( surnameDisplay, "surname" ) ； 
sqlForm. insert ( salary Edit, ’’salary” ) ； 
sqlForm. readFieldsO ； 

} 

int main( int argc, char *argv [] ) 

{ 

QApplication app( argc, argv ) ； 

if ( ! createConnections () ) return 1 ； 

FormDialog *formDialog = new FormDialogO; 

formDialog -〉 showO ； 

app. setMainWidget( formDialog ) ； 

return app. exec() ； 

} 

필요한 창문부품들을 위한 머리부파일들을 포함한다 . 보통 Qsqldatabase.h 과 
qsqlcursor.h 를 포함하지만 이번에는 qsqlform.h 를 추가한다 . 

자체의 FormDialog 클라스를 가지고 QDialog 클라스의 파생클라스를 만드므로 폼 
은 대화칸으로 제공된다 . 사용자가 월생활비를 변경하는데 QLineEdit 를 사용한다 . 모 
든 창문부품들을 살창상태로 배치한다 . 

staff 표에 유표를 창조하고 레코드들을 모두 선택하고 첫 레코드에로 이동한다 . 
이제는 QSqlForm 객체를 창조하고 QSdlForm 의 레코드완충기를 유표의 갱신완충 
기로 설정한다 . 자료를 인식하게 하려는 매개 창문부품에 대하여 창문부품의 지적자 그 
리고 관련된 마당이름을 QSqlForm 에 삽입한다 . 끝으로 readFieldsO 를 호출하여 유표 
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의 완충기를 거처서 자료기지의 자료로 창문부품들을 채워넣는다 . 

- 자료품에서 레코드현시 

QDataView 는 읽기전용 QSdlForm 을 가질수 있는 창문부품이다 . QSdlForm 과 
함께 이것은 처리부 refresh( QSqlRecord * )를 제공하므로 레코드의 구체적인 보기 
를 현시할수 있는 QDataTable 과 함께 간단히 련결될수 있다 . 

connect( myDataTable, SIGNAL ( currentChanged( QSqlRecord* ) ), 
myDataView, SLOT( refresh ( QSqlRecord* ) ) ) ； 

-레코드편집 

이 실례는 앞의것과 비슷하므로 차이에 초점을 둔다 . 

// sql/overview/form2/main. h 로부터 
class FormDialog : public QDialog 
{ 

Q—OBJECT 

public ： 

FormDialog 0; 

^FormDialog () ； 
public slots ： 
void saveO; 
private ： 

QSqlCursor staff Cursor ； 

QSqlForm *sqlForm; 

QSqllndex idlndex ； 

}； 

save 처리부는 사용자가 갱신을 확인하기 위해 누르는 단추에 사용된다 . 또한 
QSqlCursor 과 QSdlForm 의 지적자들을 보유하므로 구성자밖에서 그것들을 호출할수 
있 다 . 

staff Cursor. setT rimmed ( ’’forename", TRUE ) ； 
staff Cursor. setT rimmed ( ’’surname ’’， TRUE ) ； 

본문마당들에 대하여 setTrimmedO 를 호출하여 그 마당들을 채우는데 사용된 공 
간들은 그 마당들이 검색될 때 제거되도록 할수 있다 . 

배렬과 확인과 같이 마당들에 적용할수 있는 속성들은 관례적인 방법으로 (실례로 
QLineEdit： : setAlignmentO 와 QLineEdit： : setValidatorO 를 호출함으로써 ) 달성 할 
수 있다 . 

QLineEdit *forenameEdit = new QLineEdit ( this ) ； 

QPushButton *saveButton = new QPushButton( " 技 Save，’，this ) ； 
connect ( saveButton, SIGNAL (clicked()), this, SLOT (save ()) ) ； 
FormDialog 구성자는 앞의 실례와 비슷하다 . forename 과 surname 창문부품들을 
QLineEdit 들로 변경하여 편집가능하게 만들고 사용자가 마우스로 선택하여 갱신을 보 
관할수 있는 QPushButton 을 추가한다 . 

grid->addWidget( saveButton, 3, 0 )； 

보관단추를 포함하고있는 살창에 여분의 렬을 하나 추가한다 . 
idlndex = staff Cursor, index ( ” id” ) ； 
staff Cursor, select ( idlndex ) ； 
staff Cursor, first 0 ； 

QSqllndex 객체를 창조한 다음 색인을 사용하여 selectO 를 실행한다 . 그다음 결 
과모임의 첫 레코드로 이동한다 . 
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sqlForm = new QSqlForm( this ) ； 

sqlForm - 〉 setRecord( staff Cursor. primeUpdateO ); 

새로운 QSQlForm 객체를 창조하고 그 레코드완충기를 유표의 갱신완충기로 설정한다 . 
sqlForm - 〉 insert( forenameEdit, ’’forename” ) ； 
sqlForm->insert( surnameEdit, ’’surname” ) ； 
sqlForm->insert( salary Edit, "salary" ); 
sqlForm->readFields () ； 

이제는 완충기의 마당을 QLineEdit 조종요소들에 련결한다 . (앞의 실례에서는 유표 
의 마당들을 련결하였다 .) 편집조종요소들은 앞에서처럼 readFieldsO 호출에 의해 채워 
전다 . 

FormDialog ： 卜 FormDialogO 


해 체 자에 서 는 창문부품들이 나 QSqlForm 에 대 하여 걱 정 하지 말아야 한다 . 왜 냐하 
면 그것 들은 픔의 자식 들이 고 정 확한 순간에 Qt 에 의하여 삭제 되 기 때 문이 다 . 
void FormDialog: : save 0 
{ 

sqlForm -〉 writeFieldsO ； 
staff Cursor, update () ； 
staff Cursor, select ( idlndex ) ； 
staff Cursor, first 0 ； 

} 

끝으로 사용자가 보관단추를 누르는 순간을 위하여 보관기능을 추가한다 . 
writeFieldsO 호출에 의하여 창문부품들로부터 QSqlRecord 완충기에로 자료를 써넣는 
다 . 그다음 유표의 updateO 함수에 의해 갱신판의 레코드로 자료기지를 갱신한다 . 이 
시점에서 유표가 더는 유효레코드에 위치하지 않 으므로 QSqllndex 를 리용하여 
selectO 호출을 재발생하여 첫 레코드로 이동한다 . 

QDataBrowser 와 QDataView 는 우와 같은 기능을 대체로 제공하는 창문부품들이 
다 . QDataBrowser 는 유표의 레코드편집과 항행을 허용하는 자료픔을 제공한다 . 
QDataView 는 유표안의 자료나 자료기지레코드를 위한 읽기전용픔을 제공한다 . 

3) 사용자정 의 편집 기 창문부품들 

QSqlForm 은 QSqlPropertyMap 를 사용하여 창문부품들과 자료기지마당들사이의 
자료의 전송을 조종한다 . 사용자정 의창문부품들도 역 시 자료전송에 사용될 사용자정 의창 
문부품의 속성 들에 대 한 정 보를 포함하는 속성략도를 설 치 함으로써 품에 서 사용될수 있 
다 . 

이 실례는 앞의 소절의 form2 실례에 기초하고있으므로 여기서는 차이점만 설명한 
다 . 완전한 원천은 sql/overview/customl/main.h 와 

sql/overview/customl/main, cpp 에 있 다 . 

class CustomEdit : public QLineEdit 

{ 

Q—OBJECT 

Q_PROPERTY ( QString upperLine READ upperLine WRITE 
setUpperLine ) 
public ： 

CustomEdit ( QWidget *parent=0, const 
QString upperLine() const ； 
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char *name=0 ) ； 




void setUpperLine( const QString 技 line ) ； 
public slots ： 

void changed ( const QString &line ) ； 
private ： 

QString upperLineText ； 

}； 

QLineEdit 의 간단한 파생클라스를 창조하고 대문자판의 본문을 유지하는 
upperLineText 속성을 추가하였다 . 또한 처리부 changedO 를 창조한다 . 
QSqlPropertyMap *propMap; 

FormDialog 의 비 공개 자료에 속성 략도의 지 적 자를 추가하기 위 해 속성 략도를 사용 
하고있 다 . 

CustomEdit ： ： CustomEdit( QWidget ^parent, const char *name ) : 
QLineEdit ( parent, name ) 

{ 

connect( this, SIGNAL(textChanged(const QString 技))， 
this, SLOT (changed (const QString 技 )) ) ； 

} 

CustomEdit 구성자에서는 QLineEdit 구성 자를 사용하며 textChanged 신호와 자체 
의 changed 처리부사이에 련결을 추가한다 . 

void CustomEdit: : changed( const QString &line ) 

{ 

setUpperLine( line ) ； 

} 

changedO 처 리 부는 setUpperLineO 함수를 호출한다 . 
void CustomEdit :: setUpperLine ( const QString 技 line ) 

{ 

upperLineText = line.upperO ； 
setText( upperLineText ) ； 

} 

setUpperLineO 함수는 본문의 대문자사본을 upperLineText 완충기에 배치한 다 
음 창문부품의 본문을 이 본문으로 설정한다 . 

CustomEdit 클라스는 입 력 본문이 늘 대 문자라는것 을 담보하며 속성 략도에 의 하여 
자료기지마당들에 CustomEdit 실례들을 직접 련결하는데 쓰이는 속성을 제공한다 . 
CustomEdit *forenameEdit = new CustomEdit ( this ) ； 

CustomEdit *surnameEdit = new CustomEdit ( this ) ； 

앞에서와 같이 FormDialog 을 사용하지만 이번에는 2 개의 QLineEdit 창문부품들을 
자체의 CustomEdit 창문부품들로 바꾼다 . 

살창형태의 배 치관리 자와 유표설정은 이전과 같다 . 
propMap = new QSqlPropertyMap ； 

propMap->insert ( forenameEdit - 〉 classNameO, ’’upperLine” ) ； 

히 프에 새 로운 속성략도를 창조하고 CustomEdit 클라스와 그 upperLine 속성 을 속 
성략도에 등록한다 . 

sqlForm = new QSqlForm( this ) ； 
sqlForm->setRecord ( staffCursor->primeUpdate () ) ； 
sqlForm->instal 1PropertyMap ( propMap ) ； 

마지 막 변경 은 일 단 QSqlForm 이 창조되 면 QSqlForm 에 속성 략도를 설 치 하는것 이 
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다 . 이것은 FormDialog 가 소유하는 QSqlForm 에 속성 략도를 기 억 하게 하므로 이는 
적당한 순간에 그것들을 삭제한다 . 

이 실례의 동작은 앞의 실례와 비슷하지만 forename 과 surname 마당들이 
CustomEdit 창문부품을 사용하므로 대문자로 된다 . 

- 표의 사용자정의편집기창문부품 

표에서 사용자정의편집기창문부품을 허용하기 위해서는 QSqlEditorFactory 를 재 
정의하여야 한다 . 다음의 실례에서는 QComboBox 와 QSqlEditorFactory 과생클라스에 
기 초하는 사용자정 의 편집 기 를 창조하고 QDataTable 이 사용자정 의 편집 기 를 사용하는 
방법을 보여준다 . 

// sql/overview/table3/main.h 로부터 
class StatusPicker : public QComboBox 
{ 

Q_OBJECT 

Q_PROPERTY( int statusid READ statusld WRITE setStatusId ) 
public ： 

StatusPicker ( QWidget *parent=0, const char *name=0 ) ； 
int statusld0 const ； 
void setStatusId ( int id ) ； 
private ： 

QMap< int, int > index2id ； 

}； 

statusid 속성 을 창조하고 그것 을 위 한 READ 와 WRITE 메 쏘드들을 정 의한다 . 
status 표안의 statusid 는 복합칸의 색인들과 다르므로 QMap 를 창조하여 복합칸색인들 
을 그 복합칸에 렬거하는 statusid 들로 넘기기한다 . 

class CustomSqlEditorFactory : public QSqlEditorFactory 

{ 

Q—OBJECT 

public ： 

QWidget *createEditor( QWidget *parent, const QSqlField *field ) ； 

}； 

또한 createEditorO 는 재정의해야 할 유일한 함수이므로 이 함수를 선언하는 
QSqlEditorFactory 의 파생 클라스를 만들어 야 한다 . 

// sql/overview/table3/main, cpp 로부터 
StatusPicker ： : StatusPicker( QWidget *parent, const char *name ) 

: QComboBox( parent, name ) 

{ 

QSqlCursor cur( "status” ) ； 
cur. select( cur. index( ’’name” ) ) ； 

int i = 0 ； 

while ( cur. next () ) { 

insertltem( cur. value( "name" ).toString(), i ) ； 

index2id[i] = cur. value( ’’id” ).toInt() ； 

i ++； 

} 

StatusPicker 의 구성자에서는 name 마당에 의하여 색인화되는 status 표에 유표를 


217 





창조한다 . 그다음 복합칸에 매개 이름을 삽입하면서 status 표의 매개 레코드를 순환한 
다 . 복합칸색인과 같은 QMap 색인을 사용하여 index2id QMap 에 매개 이름에 대한 
statusid 를 보관한다 . 

int StatusPicker： : statusid () const 

{ 

return index2id [ currentltemO ] ； 

} 

statusid 속성 READ 함수는 복합칸색인들을 statusid 들로 사영하는 index2id 
QMap 안에서 현재 선택된 항목들에 대하여 복합칸색인의 검색기능을 포함한다 . 
void StatusPicker ： : setStatusId( int statusid ) 

{ 

QMap<int, int> :: Iterator it ； 

for ( it = index2id.begin() ； it != index2id.end() ； ++it ) { 
if ( it. data() == statusid ) { 
setCurrentItem( it. key0 ); 
break ； 

} 

} 

} 

statusIdO 함수는 statusid 속성의 WRITE 함수를 실현한다 . QMap 에 대하여 반복 
자를 창조하고 index2id QMap 를 순환한다 . 매개 index2id 요소들의 자료 (statusid) 를 
id 파라메터 들의 값과 비 교한다 . 일치 하는것 이 있으면 복합칸의 현재 항목을 indexed 요 
소의 열쇠 (복합칸색 인)로 설정 하고 순환고리 를 벗 어난다 . 

사용자가 QDataTable 의 status 마당을 편집할 때 status 표로부터 취해진 유효상태 
이름들이 복합칸에 표시된다 . 그러나 표시된 상태는 아직 본래의 statusid 이다 . 마당을 
편집 하지 않을 때 상태이 름을 현시 하려 면 QDataTable 의 파생 클라스를 만들고 
paintFieldO 함수를 재정의하여야 한다 . 

// sql/overview/table4/main.h 로부터 
class CustomTable : public QDataTable 
{ 

Q—OBJECT 

public ： 

CustomTable(QSqlCursor *cursor, bool autoPopulate = FALSE, 

QWidget * parent = 0, const char * name = 0 ) ： 

QDataTable( cursor, autoPopulate, parent, name ) {} 

void paintField(QPainter * p, const QSqlField* field, const QRect 技 cr, bool ) ； 


아무것도 변경하지 않고 원래의 QDataTable 구성자를 단순히 호출한다 . 또한 
paintField 함수를 선언한다 . 

// sql/overview/table4 / main, cpp 로부터 
void CustomTable ： : paintField( QPainter * p, const QSqlField* field, 
const QRect & cr, bool b) 

{ 

if ( ! field ) 
return ； 
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if ( field->name() == ’’statusid” ) { 

QSqlQuery query ( ” SELECT name FROM status WHERE id=” + 
field-〉value 0. toString () ) ； 

QString text ； 
if ( query, next() ) { 
text = query, value( 0 ).toString() ； 

} 

rr>drawText( 2,2, cr.width()-4, cr.height()-4, fleldAlignment( field ), text )； 

} 

else { 

QDataTable： : paintField( p, field, cr, b) ； 

} 

paintField 코드는 QDataTable 의 원천코드에 기초하고있다 . 3 가지 변경이 필요하 
다 . 첫째로， if 절 field->name() == ’’statusid” 를 추가하고 간단히 QSqlQuery 에 의 
해 id 의 본문값을 찾는다 . 둘째로，웃준위클라스를 호출하여 다른 마당들을 조종한다 . 
끝으로 staffTable 을 QDataTable 로부터 CustomTable 로 변경하는 main 함수가 있어 
야 한다 . 

7. QSqlCursor 의 파생들라스작성 

// sql/overview/subclassl/main. cpp 로부터 
#include <qapplica 仕 on. h> 

#include <qsqldatabase. h> 

#include <qsqlcursor. h> 

#include <qdatatable. h> 

#include ".. /connection, h" 


int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ) ； 


if ( createConnections () ) { 

QSqlCursor invoiceltemCursor( "invoiceitem" ) ； 


QDataTable *in voiceltemT able = new 

QDataTable ( 技 invoiceltemCursor ) ； 

app. setMainWidget ( invoiceltemTable ) ； 


invoiceItemTable->addColumn ( ” pricesid’’ ， "PricelD" ) ； 
invoiceltemTable - 〉 addColumn( "quantity", "Quantity" ) ； 
invoiceItemTable->addColumn( "paiddate”, ’’Paid” ) ； 


invoiceltemTable—>refresh () ； 
in voiceltemT able->show () ； 


return app. exec() ； 
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} 


return 1 ； 

} 

이 실례는 처음에 제시한 tablel 실례와 거의 비슷하다 . 유표를 창조하고 마당들과 
그 형의 표식자들을 QDataTable 에 추가하고 refreshO 를 호출하여 자료를 적재하고 
show 0 를 호출하여 창문부품을 표시한다 . 

그렇지만 이 실례는 충분하지 않다 . 표이름설정과 이 표에 유표가 요구될 때마다 
마당들의 사용자정의특성을 설정하는것은 시끄러운 일이 다 . 그리고 pricesid 보다도 제품 
의 이름을 현시하면 더 좋을수 있다 . 제품의 가격과 량을 알고있으므로 제품의 가격과 
매 개 invoiceitem 의 가격 을 표시 할수 있 다 . 끝으로 사용자가 새 레 코드를 추가할 때 일 
부 값들을 기 정 으로 한다면 쓸모있 다 . (혹은 주열 쇠 도 본질적 이다 . ) 

// sql/overview/subclass2 / main, h 로부터 
class InvoiceltemCursor : public QSqlCursor 
{ 

public ： 

InvoiceltemCursor() : 

}； 

개별적인 머리부파일을 창조하고 QSqlCursor 파생들라스를 만든다 . 

// sql/overview/subclass2 / main, cpp 로부터 
InvoiceltemCursor： : InvoiceltemCursor() : QSqlCursor( "invoiceitem" ) 

{ 

// NOOP 

} 

들라스의 구성자에서는 표의 이름을 가지고 QSqlCursor 구성 자를 호출한다 . 이 단 
계에서 다른 특성을 추가하지 않는다 . 

InvoiceltemCursor InvoiceltemCursor ； 
invoiceitem 표에 유표를 요구할 때마다 QSqlCursor 대신에 InvoiceltemCursor 
를 창조할수 있다 . 

아직은 pricesid 가 아니 라 제품 id 를 표시 해 야 한다 . 

// sql/overview/subclass3 / main, h 로부터 
protected ： 

QVariant calculateField( const QString & name ); 

머리부파일에서의 변경은 극히 적다 . 단지 calculateFieldO 함수를 재정의하므로 
그 선언을 추가한다 . 

// sql/overview/subclass3/main. cpp 로부터 
InvoiceltemCursor :: InvoiceltemCursor() : 

QSqlCursor( "invoiceitem" ) 

{ 

QSqlFieldlnfo productName( "productname", QVariant： : String ); 

append ( productName ); 

setCalculated( productName. name 0， TRUE ); 


QVariant InvoiceltemCursor :: calculateField ( const QString & name ) 

{ 
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if ( name == "productname" ) { 

QSqlQuery query ( ’’SELECT name FROM prices WHERE id=” + 
field( ” pricesid” )->value(). toString() ) ； 
if ( query, next() ) 
return query, value ( 0 ) ； 

} 

return QVariant( QString： : null ) ； 

} 

InvoiceltemCursor 구성 자를 변경하였다 . 이제 productname 이라는 QSqlField 를 
새로 창조하고 이것을 InvoiceltemCursor 의 마당모임에 추가한다 . productname 에 
대하여 setCalculatedO 를 호출하여 그것을 계산된 마당으로서 식별한다 . 
setCalculatedO 에로의 첫 인수는 마당이름이고 둘째 인수는 마당값을 얻기 위하여 
calculateFieldO 가 호출해 야 한다는것 을 TRUE 로 표시 하는 bo 이형 이다 . 

invoiceItemTable->addColumn( "productname", ” Product” ) ； 
addColumnO 에 의해 폼에 새 마당들을 추가하고 그 현시마당들을 설정한다 . 

자체 의 calculateFieldO 함수를 정의 해야 한다 . 실례 자료기 지 에서 invoiceitem 표 
의 pricesid 는 prices 표에로의 외부열쇠이다 . pricesid 를 사용하여 prices 표에 대하여 
질문을 실행함으로써 제품의 이름을 찾는다 . 이것은 제품의 이름을 돌려준다 . 

이제는 실례를 확장하여 실제 계산을 수행하는 계산마당들을 포함할수 있다 . 

머리부파일 sql/overview/subclass4/main.h 는 앞의 실례로부터 변경되지 않지 
만 구성자와 calculateFieldO 함수는 간단한 확장을 요구한다 . 매개를 차례로 고찰한다 . 
// sql/overview/subclass4/main. cpp 로부터 
InvoiceltemCursor :: InvoiceltemCursor() : 

QSqlCursor( "invoiceitem" ) 

{ 

QSqlFieldlnfo productName( ’’productname”, QVariant： : String ) ； 
append ( productName ) ； 

setCalculated( productName. nameO, TRUE ) ； 

QSqlFieldlnfo productPrice( "price”, QVariant： : Double ) ； 
append ( productPrice ) ； 

setCalculated( productPrice. nameO, TRUE ) ； 


QSqlFieldlnfo productCost( ’’cost”, QVariant： : Double ) ； 
append ( productCost ) ； 

setCalculated( productCost. name (), TRUE ) ； 

} 

두개의 특수마당 price 와 cost 를 창조하여 유표의 마당모임에 추가한다 . 둘다 
setCalculatedO 호출에 의하여 계산마당에 등록된다 . 

// sql/overview/subclass4/main. cpp 로부터 
QVariant InvoiceltemCursor :: calculateField( const QString & name ) 

{ 


if ( name == ” productname’’ ) { 

QSqlQuery query ( ” SELECT name FROM prices WHERE id=” + 
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field( "pricesid” )->value(). toString () ) ； 
if ( query, next() ) 
return query, value ( 0 ) ； 

} 

else if ( name == "price" ) { 

QSqlQuery query ( ’’SELECT price FROM prices WHERE id=，， + 
field( "pricesid” )->value (). toString () ) ； 
if ( query, next() ) 
return query, value ( 0 ) ； 

} 

else if ( name == ’’cost’，) { 

QSqlQuery query ( ’’SELECT price FROM prices WHERE id=，，+ 
field( "pricesid" )->value(). toString() ) ； 
if ( query, next() ) 

return QVariantC query.value( 0 ).toDouble() * 
value( ” quantity”).toDouble() ); 

} 

return QVariant( QString： : null ) ； 

} 

calculateFieldO 함수는 현재 3 개의 서로 다른 마당들의 값을 계산해야 하므로 현 
저하게 확장되였다 . productname 과 price 마당들은 prices 표에서 pricesid 를 열쇠로 
하는 대응하는 값들을 탐색하여 생성한다 . cost 마당은 price 에 quantity 을 곱하여 간단 
히 계산할수 있다 . 단가는 calculateFieldO 가 돌려주어야 할 형인 QVariantC 강제변 
환된 다 . 

매개 계산마당이 각이한 표나 보기에 대한 검색으로 될수 있는 실제응용프로그람과 
비슷한 실례로 만들기 위하여 하나가 아니라 3 개의 개별적인 질문을 썼다 . 

추가해야 할 마지막 기능은 사용자가 새 레코드를 삽입하려고 시도할 때의 기정값 
들이 다 . 

// sql/overview/subclass5/main. h 로부터 
QSqlRecord *primelnsert() ； 

자체의 primelnsertO 함수를 재정의하기 위하여 이 함수를 선언한다 . 

구성자와 calculateFieldO 함수는 변경되지 않는다 . 

// sql/overview/subclass5/main, cpp 로부터 
QSqlRecord *invoiceltemCursor :: primelnsertO 
{ 

QSqlRecord *buffer = editBufferO ； 

QSqlQuery query ( ’’SELECT NEXTVAL( ’ invoiceitem_seci ， 
if ( query, next() ) 

buffer->setValue( "id", query.value( 0 ) ); 
buffer->setValue ( "paiddate", QDate： : currentDateO ); 
buffer->setValue( ’’quantity”, 1 ) ； 

return buffer ； 

} 

유표가 삽입과 갱신에 사용되는 내부편집완충기의 지적자를 얻는다 . id 마당은 


222 




invoiceitem_seq 에 의해 생성되는 유일한 옹근수이다 . paiddate 마당의 기정값을 오늘 
의 날자로 설정하고 Quantity 의 기정값을 1 로 설정한다 . 끝으로 완충기의 지적자를 돌 
려준다 . 나머지 코드는 이전판으로부터 변경되는것이 없다 . 

8. 실례표들 

사용된 실 례 표들은 다음의 표준 SQL 에 의 해 다시 창조될 수 있 다 . 자기 의 특정한 자 
료기 지 에 사용하는것 과 일 치하도록 SQL 을 수정할 필 요가 있 다 . 

create table people (id integer primary key, name char(40)) 
create table staff (id integer primary key, forename char(40), 
surname char(40), salary float, statusid integer) 
create table status (id integer primary key, name char(30)) 
create table creditors (id integer primary key, forename char(40), 
surname char(40), city char(30)) 

create table prices (id integer primary key, name char(40), price float) 
create table invoiceitem (id integer primary key, 

pricesid integer, quantity integer, paiddate date) 

우의 calculateFieldO 실례에서는 순서렬을 리용하였다 . 순서렬은 모든 자료기지들 
에서 유지되는것은 아니 라는것을 알아야 한다 . 
create sequence invoiceitem_seq 

9. 지원하는 구동프로그람들 

SQL 모둘은 각이한 자료기 지 API 들과 교제 하기 위하여 구동프로그람플라그인을 사 
용한다 . SQL 모둘 API 가 자료기지 에 의존하지 않으므로 모든 자료기지 에 고유한 코드는 
이 구동프로그람들내에 포함된다 . 일부 구동프로그람들은 Qt 와 함께 공급되고 다른 일 
부는 추가될수 있 다 . 구동프로그람원천 코드가 공급되 고 자체 의 구동프로그람쓰기 를 위 한 
모형으로 사용될수 있다 . 

알아두기 : 구동프로그람플라그인을 구축하기 위하여 자기 의 자료기 지 관리 체 계용의 
적당한 의뢰기서고를 가지고있어야 한다 . 이것은 DBMS 에 의해 공개된 API 에로의 접 
근을 제공한다 . 대 다수 설치프로그람들도 사용자의 요구에 따라《 개 발서 고》를 설치한 
다 . 이 서고들은 DBMS 와의 저수준통신을 보장할수 있다 . 

Qt 에 적재되는 구동프로그람들은 다음과 같다 . 

•QDB2 - IBM DB2 구동프로그람 (v7.1 이상 ) 

• QIBASE - Borland Interbase 구동프로그람 

• QMYSQL3 - MySQL 구동프로그람 

• QOCI8 - Oracle Call Interface 구동프로그람 , 8，9 및 10 판 

• QODBC3 - Open Database Connectivity 구동프로그람 

• QPSQL7 - PostgreSQL v6.x and v7.x 구동프로그람 

• QSQLITE - SQLite 구동프로그람 

• QTDS7 - Sybase Adaptive Server 

•GPL 허가의 비호환성으로인하여 Qt 공개원천판으로 모두 적재되는것은 아니다 . 

1) configure 를 리용한 구동프로그람들의 구축 

Qt configure 스크립트는 자동적으로 자기 콤퓨터에서 유효의뢰기서고들을 람지한 
다 . 어 떤 구동프로그람들을 구성할수 있는가 알려 면 ’’configure -help ” 를 실행 한다 . 
다음과 비슷한 출력이 얻어진다 . 

Possible values for 〈 driver〉mysql oci odbc psql tds ] 

Auto-Detected on this system ： [ mysql psql ] 
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Windows 에서는 configure 스크립트가 자동탐지 되지 않는다 . 
configure 스크립 트는 필 요한 서 고와 머 리 부파일 들이 표준경 로에 없 으면 탐지 할수 
없으므로 "-I ” 과 ” -L" 스위치들을 리용하여 이 경로들을 지정할 필요가 있다 . 실례로 자 
기의 MySQL 머리부파일들은 /usr/local/mysql 에 (혹은 C:\mysql\include configure ： - 
I/usr/local/mysql (혹은 -I C:\mysql\include Windows). 

Windows 에서 -I 파라메터 는 파일 이 름에서 공백 을 받아들이 지 않으므로 8. 3 이 름형 
식 을 리 용한다 . 즉 C:\progra~l\mysql 을 C:\program files\mysql 대 신 에 리 용한다 . 

자료기 지 구동프로그람을 자기 의 Qt 서 고에 정 적 으로 구축하는데 -qt-sql-< 구동프로그 
람 > 파라메터 를 리용하고 구동프로그람을 플라그인으로서 구축하는데 -plugin-sql-< 구동프 
로그람 > 을 리용한다 . 

2) 수동적인 플라그인구축 

(1) QMYSQL3 - MySQL 3.x 과 MySQL 4.x 

- 일반정보 

MySQL 3 . 표는 기정으로 SQL 일괄처리를 유지하지 않는다 . 이 기능을 제공하는 
backend 들이 있다 . MySQL 의뢰기서고들의 최근판 (>3.23.34 ) 은 그 수정된 봉사기들 
에서 일갈처리를 리용하게 한다 . 

최근의 의뢰기서고를 가지 고있고 일괄처 리가능한 MySQL 봉사기 에 련결한다면 
QSqlDriver ： : hasFeature( QSqlDriver： : Transactions ) 함수호출은 TRUE 를 돌려 
주고 SQL 일괄처 리를 사용할수 있다 . 

플라그인이 MySQL 4.x 의뢰기서 고들에 대 하여 콤파일되면 일갈처 리는 기정 으로 
가능해진다 . 

http://www. mysql.com 에서 MySQL 에 대한 정보를 찾을수 있 다 . 

- Unix/Linux 에서 플라그인구축방법 

MySQL 머 리 부파일 들가 공유서 고 libmysqlclient.so 를 요구한다 . 자기 의 Linux 배 포 
물에 따라서 보통 "mysql-devel " 이라고 부르는 패키지를 설치해야 한다 . 

qmake 는 MySQL 머리부파일과 공유서고들을 어디서 찾는가 말하고(여기서는 
MySQL 이 /usr/local 에 설치 되 여있다고 가정한다 ) make 를 실행한다 . 
cd SQTDIR/plugins/src/sqldrivers/mysql 

qmake -o Makefile "INCLUDEPATH+=/usr/local/include" "LIBS+=- 
L/usr/local/lib -lmysqlclient" mysql.pro 
make 

- Windows 에서 플라그인구축방법 

MySQL 설치파일들을 엄어야 한다 . SETUP.EXE 를 실행하고 "Custom Install" 
을 선택한다 . "Libs & Include Files ” 모둘을 설치한다 . 프라그인을 다음과 같이 구축 
한다 . (여 기서는 MySQL 이 C:\MYSQL 에 설 치된다고 가정한다 . ) 
cd %QTDIR%\plugins\src\sql 구동프로그람 s\mysql 

qmake -o Makefile " INCLUDEP ATH+=C : \MYSQL\INCLUDE" 

"LIBS+=C : \MYSQL\LIB\OPT\LIBMYSQL.LIB" mysql.pro 
nmake 

Microsoft 틈파일러를 리 용하지 않는다면 우의 문에서 nmake 를 make 로 교체 한다 . 

(2) QOCI8 - Oracle 호출대면부 (OCI) 

- 일반정보 

Qt OCI 플라그인은 Oracle 8 과 Oracle 9 을 둘다 유지한다 . Oracle 봉사기에 련결 
한 다음 플라그인은 자료기지판과 가능한 특성들을 자동탐지한다 . 

- 유니 코드지 원 
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Oracle 봉사기가 유니코드를 유지하면 OCI 플라그인은 UTF-8 부호화를 리용하여 봉 
사기 와 교제한다. 

- BLOB/LOB 지 원 

BLOB (Binary Large Object) 를 읽고 쓸수 있으나 이 과정이 많은 기억기를 요구 
한다는것을 알아야 한다. 

Oracle 9는 LOB 렬들을 가지는 흘림가능결과모임을 유지하지 않으며 정방향질문만 
리 용하여 LOB 마당을 선택 할수 있 다 (QSqlQuery: :setForwardOnly() 참고) . 

BLOB 삽입은 BLOB 가 대리기호로 제한되는 준비된 질문 혹은 내적으로 이것을 수 
행하는 준비된 질문을 리용하는 QSqlCursor 를 리용하여 수행되여야 한다 
($QTDIR/examples/sql/blob 참고) . 

- Unix/Linux 에서 플라그인구축방법 

구동프로그람구축에 필요한 모든 파일들은 표준 Oracle 의뢰기를 적재해야 한다. 
Oracle 서고파일들이 구동프로그람구축에 필요하다. 

• libclntsh.so (모든 판) 

• libwtc8.so (Oracle 8만) 혹은 libwtc9.so (Oracle 9만) 

qmake 는 Oracle 머리 부파일과 공유서 고들을 어디서 찾는가 말하고 (변수 
$ORACLE_HOME 가 Oracle 이 설 치되 는 등록부를 가리 킨다고 가정한다) make 를 실행한 
다. 

Oracle 8을 리용하고있다면 
cd $QTDIR/plugins/src/sql 구동프로그람 s/oci 

qmake -o Makefile "INCLUDEPATH+=$ORACLE_HOME/rdbms/public 
$ORACLE_HOME/rdbms/demo" "LIBS+=-L$ORACLE_HOME/lib -lclntsh - 
lwtc8" oci.pro 
make 

Oracle 9 를 리용한다면 

cd $QTDIR/plughis/src/sql 구동프로그람 s/oci 

qmake -o Makefile "INCLUDEPATH+=$ORACLE_HOME/rdbms/public 
$ORACLE_HOME/rdbms/demo" "LIBS+=-L$ORACLE_HOME/lib -lclntsh - 
lwtc9" oci.pro 
make 

Oracle 10 을 사용한다면 

cd $QTDIR/plugins/src/sql 구동프로그람 s/oci 

qmake -o Makefile "INCLUDEPATH+=$ORACLE_HOME/rdbms/public 
$ORACLE_HOME/rdbms/demo" "LIBS+=-L$ORACLE_HOME/lib -lclntsh" oci.pro 
make 

일부 판의 OCI 의뢰기서고들은 완료시에 이 서고에 련결된 프로그람들은 
segmentation fault 오유를 일으킨다. 이것은 QOCI8 구동프로그람이 플라그인으로서 
롬파일 되 면 발생한다. 이 문제 에 대 하여 작업 하기 위하여 Qt 서 고자체 로 구동프로그람을 
름파일 하거 나 선택 ’-DQT_NO_LIBRARY_UNLOAD’ 를 가지 고 어를 구성 한다. 
Oracle 9에서는 "LIBS+=$ORACLE_HOME 八 ib/libclntst9.a" 를 리용하여 정적 OCI 
서고에 련결할수 있다. 

- Windows 에서 플라그인구축방법 

Oracle 의뢰기설치 CD 로부터 Oracle 의뢰기설치프로그람에서 ’’Programmer" 를 선 
택하면 풀라그인구축에 충분하다. 

플라그인을 다음과 같이 구축한다. (여 기서 Oracle 의뢰기 가 C:\oracle 에 설치된다는 
것 을 가정한다. ) 
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set INCLUDE=%INCLUDE% ； c ： \oracle\oci\include 
set LIB=%LIB% : c : \oracle\oci\lib\msvc 
cd %QTDIR%\plugins\src\sql 구동프로그람 s\oci 
qmake -o Makefile oci.pro 
nmake 

자기 응용프로그람을 실행할 때 자기의 PATH 환경변수에 od.dll 경로를 추가해야 한다 . 
set PATH=%PATH%;c:\oracle\bin 

Microsoft 를파일 러 를 사용하지 않는다면 우의 문에 서 nmake 를 make 로 교체 한다 . 

(3) QODBC3 - Open Database Connectivity (ODBC) 

- 일반정보 

ODBC 는 공통대 면부를 리 용하여 여 러 DBMS 에 련결하게 하는 일 반대 면부이다 . 
QODBC3 구동프로그람은 ODBC 구동프로그람관리 기 에 련결하고 유효자료원천들을 호출 
하게 한다 . 또한 자기 체계에 설치되는 ODBC 구동프로그람 관리기용의 ODBC 구동프 
로그람들을 설치하고 환경을 구성해야 한다 . 그때 QODBC3 플라그인은 자기의 Qt 프로 
젝트에서 이 자료원천들을 사용하게 한다 . 

Windows 95 이후의 체계들에서 ODBC 구동프로그람관리기는 기정으로 설치되여야 
하고 Unix 체 계 에서 우선 설치하여 야 할 실현이 있다 . 자기 응용프로그람을 사용하는 
각 의뢰기 는 설치된 ODBC 구동프로그람관리 기 가 있어 야 하며 그렇지 않으면 QODBC3 
플라그인은 동작하지 않는다 . 

ODBC 자료원천에 련결 할 때 실제자료기 지이 름이 아니 라 ODBC 자료원천의 이 름을 
QSqlDatabase ： : setDatabaseName() 함수에 넘 겨 야 한다 . 

QODBC3 플라그인은 ODBC 호환구동프로그람 관리 기 2.0 이 후에서 작업할것 을 요구 
한다 . 일부 ODBC 구동프로그람들은 2.0 판호환을 요구하지만 필요한 모든 기능을 제공 
하지 않는다 . 그러므로 QODBC3 플라그인은 자료원천을 련결이 확립된 후에 사용할수 
있는가 검 사하고 검사가 실패하면 작업 을 거부한다 . 이 렇게 동작하지 않는다면 파일 
qsql_odbc.cpp 에 서 #define ODBC_CHECK_DRIVER 행 을 삭제 할수 있 다 . 

ODBC 자료원천의 아주 느린 호출을 보았다면 ODBC 호출추적이 ODBC 자료원천 관 
리기에서 차단된다는것을 확인한다 . 

- 유니 코드지 원 

QODBC3 플라그인은 UNICODE 가 정의되면 유니코드 API 를 사용한다 . Windows 
NT 기 반체계 에서 이것은 기정 이다 . ODBC 구동프로그람과 DBMS 가 물론 유니코드를 유 
지해 야 한다 . 

Oracle 9 ODBC 구동프로그람 (Windows) 에 대하여 ODBC 구동프로그람 관리기에 
서 "SQL_WCHAR support " 을 검사할 필요가 있으며 그렇지 않으면 Oracle 은 모든 
유니코드문자렬을 국부 8 bit 로 변환한다 . 

- Unix/Linux 에서 플라그인구축방법 

unixODBC 를 리 용할것을 권고한다 . h 竹 p://www.unixodbc.org 에서 최 근판과 
ODBC 구동프로그람들을 찾을수 있다 . unixODBC 머 리 부파일과 공유서 고들을 요구한다 . 

qmake 에게 어디서 unixODBC 머리부파일과 공유서고들을 찾는가를 알리고(여기서 
는 unixODBC 가 /usr/local/unixODBC 에 설치된다고 가정 ) make 를 실행한다 . 
cd SQTDIR/plugins/src/sqldrivers/odbc 

qmake " INCLUDEP ATH+=/usr/ local /unixODBC/include" "LIBS+=- 

L/usr/local/unixODBC/lib -lodbc" 
make 

- Windows 에서 플라그인구축방법 

ODBC 머 리부파일들은 이미 정 확한 등록부들에 설치되여있어 야 한다 . 다음과 같이 
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플라그인을 구죽해야 한다 . 

cd %QTDIR%\plugins\src\sql 구동프로그람 s\o( 比 ) c 

qmake _o Makefile odbc.pro 

nmake 

Microsoft 콤파일 러 를 사용하지 않는다면 우의 문에 서 nmake 를 make 로 교체 한다 . 

(4) QPSQL7 - PostgreSQL 6 판과 7 판 

- 일반정보 

QPSQL7 구동프로그람은 PostgreSQL 6 판과 7 판을 둘다 유지한다 . 최 근판의 
PostgreSQL 의뢰기서고 (1 比 ) pq ) 가 안전하고 역호환되므로 이것을 가지고 를파일할것을 
권고한다 . 

6 판에 서 실은 libpq 에 플라그인을 련결 하려 고 한다면 PostgreSQL 6. 5. 3 과 같은 
현재판을 권고하며 그렇지 않으면 7 판의 봉사기에 대한 련결이 동작하지 않는다 . 

구동프로그람은련결이 성공한 후에 PostgreSQL 의 봉사기판을 자동람지한다 . 봉사 
기 가 너 무 낡거 나 판정 보를 결 정할수 없 으면 경 고가 발생 된 다 . 

- 유니 코드지 원 

QPSQL7 구동프로그람은 련결하고있는 PostgreSQL 자료기지가 유니코드를 지원하 
는가 안하는가를 자동적으로 람지한다 . 유니코드는 봉사기가 그것을 지원한다면 자동적 
으로 사용된다 . 구동프로그람은 오직 UTF-8 부호화만 유지한다 . 자기의 자료기지가 다 
른 부호화를 사용한다면 봉사기는 유니코드변환을 유지하여 를파일되여 야 한다 . 

유니코드유지는 PostgreSQL 7.1 판에서 도입되였으며 봉사기와 의뢰기의 두 서고 
가 여 러바이트를 유지하여 를파일되였으면 동작한다 . (PostgreSQL 봉사기를 여 러바이트 
가 가능하게 설정하는 방법에 대한 자세한 정보는 《PostgreSQL Administrator 
Guide 》 제 5 장을 보시오 .) 

- BLOB 지원 

대 규모 2 진객 체 (Binary Large Object ) 는 PostgreSQL 7.1 판이 상에서 BYTEA 마 
당을 통하여 지원된다 . OID 형의 마당들은 읽어들일수 있으나 써 넣기할수 없다 . 
PostgreSQL 지령 lo_import 를 리용하여 0正) 마당들에 2 진자료를 삽입한다 . 

- Unix/Linux 에서 플라그인구축방법 

pq 의뢰기서고와 대응하는 머리부파일들을 설치하는것으로 충분하지 않다 . 
PostgreSQL 원천배포물을 얻어서 환경구성스크립트를 실행해야 한다 . 2 진배포물을 이 
미 설치하였다면 그것을 구축할 필요가 없다 . 원천배포물은 QPSQL7 플라그인이 보통 2 
진배포물의 부분이 아닌 한쌍의 머리부파일들에 기초하므로 필요된다 . 

qmake 가 PostgreSQL 머 리 부파일 과 공유서 고들을 찾게 하기 위 하여 qmake 가 다음 
과 같은 방법 으로 실 행 한다 . (PostgreSQL 원천은 /usr/src/psql 에 서 찾을수 있 다는것 을 
전제로 한다 .) 

cd $QTDIR/plugins/src/sqldrivers/psql 

qmake -o Makefile "INCLUDEPATH+=/usr/src/psql/src/include 

/ usr/src/psql/src/interfaces/libpq" "LIBS+=-L/usr/lib -lpq" psql.pro 
make 

- Windows 에서 플라그인구축방법 

PostgreSQL 문서에서 설명 하는것처럼 PostgreSQL 원천배포물을 풀고 구축한다 . 
PostgreSQL 원천이 C:\psql 에 상주한다는것을 전제로 하고 플라그인을 다음과 같이 구 
축한다 . 

cd %QTDIR%\plugins\src\sql 구동프로그람 s\psql 

qmake -o Makefile "INCLUDEPATH+=C ： \psql\src\include 
C : \psql\src\interfaces\libpq" psql. pro 
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nmake 

libpq.dll 서고에로의 경로를 자기의 PATH 환경 변수에 추가하여 Windows 가 그것을 
찾을수 있도록 해야 한다 . 이 경우에 C:\psql\src\interfaces\libpq\Release. Microsoft 콤파일 
러 를 사용하지 않는다면 우의 문에 서 nmake 를 make 로 교체한다 . 

(5) QTDS7 - Sybase Adaptive Server 

- Unix/Linux 에서 플라그인구축방법 

Unix 하에서 TDS 통신규약을 지원하는 두 서고를 사용할수 있 다 . 

- FreeTDS, TDS 통신규약 (http://www.freetds.org) 의 자유실현 . FreeTDS 
를 아직 안정 하지 않으므로 어떤 기능은 기대 한대 로 동작하지 않을수 있다 . 

- Sybase 공개의뢰기， http://www.sybase.com 로부터 얻을수 있다 . Linux 사용 
자들은 http://linux. Sybase, com 로부터 공개의뢰 기 RPM 을 얻을수 있 다 . 

사용하는 서 고에 관계 없 이 공유목적파일 libsybdb.so 이 필 요하다 . SYBASE 환경 변수 
가 의뢰기서고를 설치한 등록부를 가리키 게 설정 하고 qmake 를 실행한다 . 
cd $QTDIR/plugins/src/sqldrivers/tds 

qmake -o Makefile "INCLUDEPATH=$SYBASE/include" "LIBS=- 
L$SYBASE/lib -lsybdb" 
make 

- Windows 에서 플라그인구축방법 

Microsoft 나 Sybase 공개의뢰기 (http://www.sybase.com) 에 의해 제공되는 DB- 
Ubrary 를 사용할수 있다 . 플라그인을 구축하려면 NTWDBLIB.LIB 을 포함해 야 한다 . 
cd %QTDIR%\plugins\src\sql 구동프로그람 s\tds 
qmake -o Makefile "LIBS+=NTWDBLIB. LIB" tds.pro 
nmake 

기정으로 Microsoft 서고는 Windows 에서 사용되므로 Sybase 공개의뢰기사용을 요 
구하면 %QTDIR%\src\sql\ 加 vers\tds\qsql_tds.cpp 에서 Q_USE_SYBASE 를 정의해 야 한다 . 

(6) QDB2 - IBM DB2 구동프로그람 (v7.1 이김가 

- 일반정보 

Qt DB2 플라그인은 IBM DB2 자료기지들을 호출할수 있게 한다 . IBM DB2 v7.1 
과 7. 2 를 가지 고 시 험하였 다 . QDB2 플라그인의 롬파일 에 필요한 머 리 부와 서 고파일들 
을 포함하는 IBM DB2 개 발의뢰기서고를 설치해 야 한다 . 

QDB2 구동프로그람은 준비되 여있는 질문，유니 코드문자렬의 읽 고 쓰기 및 BLOB 의 
읽고 쓰기를 지원한다 . 

DB2 에 보관된 수속들을 호출할 때 정방향의 질문만 사용할것을 제안한다 
(QSqlQuery :: setForwardOnly 0 참고 ) . 

- Unix/Linux 에서 플라그인구축방법 

cd $QTDIR/plugins/src/sql 구동프로그람 s/db2 

qmake -o Makefile "INCLUDEPATH+=$DB2DIR/include" "LIBS+=- 
L$DB2DIR/lib -ldb2" 
make 

- Windows 에서 플라그인구축방법 

DB2 머리부파일들은 이미 정학한 등록부에 설치되여야 한다 . 플라그인을 다음과 같 
이 구죽해 야 한다 . 

cd %QTDIR%\plugins\src\sqldrivers\db2 
qmake -o Makefile "INCLUDEPATH+=<DB2 home>/sql lib/include" 
"LIBS+=<DB2 home>/sqllib/lib/db2cli. lib" 
nmake 
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Microsoft 콤파일 러 를 사용하지 않는다면 우의 문에 서 nmake 를 make 로 교체 한다 . 

(7) QSQLITE - SQLite 구동프로그람 

Qt SQLite 플라그인은 SQLite 자료기지를 호출할수 있게 한다 . SQLite 는 프로쎄스 
내자료기지 이 다 . 이것은 자료기지 봉사기를 가질 필요가 없다는것 을 의미 한다 . SQLite 는 
련결을 열 때 자료기지이름으로서 설정 되 여 야 하는 하나의 파일 에 조작한다 . 그 파일 이 
존재하지 않으면 SQLite 는 그것을 창조하려고 한다 . 또한 SQLite 는 기억기내자료기지 
들을 지 원하며 단지 자료기지이름으로서 ": memory :" 를 넘긴다 . 

SQLite 는 다중사용자들과 다중일괄처리에 관한 제한이 있다 . 각이한 일괄처리에 
대하여 읽기와 쓰기를 하려면 자기 응용프로그람은 하나의 일괄처리를 위임하거나 역전 
될 때까지 해방할수 있다 . 

SQLite 는 형에 대한 지원이 없으며 매개 값은 문자자료로서 취급된다 . 그러므로 
BLOB 는 유지되지 않는다 . 

http://www.sqlite.org 에서 SQLite 에 대 한 정보를 찾을수 있 다 . 

SQLite 는 Qt 에서 제 3 자서고로서 적재된다 . configure 스크립트에 다음의 파라메 터 
들을 넘기여 구축한다 . 즉 -plugin-sql-sqlite ( 플라그인로서 ) 혹은 -qt-sql-sqlite (Qt 서고에 
로 직접 련결 ). 

Qt 에 적재된 SQLite 서고를 사용하지 않으면 수동적으로 구축할수 있다 . ($SQLITE 
를 SQLite 가 상주하는 등록부로 바꾼다 .) 

cd $QTDIR/plugins/src/sqldrivers/sqlite 

qmake -o Makefile "INCLUDEPATH+=$SQLITE/include" "LIBS+=- 
L$SQLITE/lib -lsqlite" 
make 

(8) QIBASE - Borland Interbase 구동프로그람 

- 일반정보 

Qt Interbase 플라그인은 Interbase 와 Firebird 자료기지의 호출을 간단하게 한다 . 
mterbase 는 의뢰 기-봉사기 로서 사용되거 나 국부파일들에 조작하는 봉사기없이 사용될 
수 있다 . 자료기지파일은 련결이 이루어지기 전에 존재해야 한다 . 

Interbase 는 자료기 지 파일 에 로의 완전경 로를 지 정 할것 을 요구하며 그것 이 국부적 으 
로 혹은 다른 봉사기 에 보관되 여있으면 문제 가 생 기지 않는다 . 
myDatabase->setHostName(" My Server") ; 
myDatabase->setDatabaseName("C ： Wtest.gdb") : 

이 플라그인을 구축하려면 Interbase/Firebird 개발머리부와 서고들이 요구된다 . 
GPL 로 인하여 Qt 공개원천판의 사용자들은 이 플라그인을 Interbase 의 상업판에 련결 
하는것 이 허용되지 않는다 . Firebird 를 사용하거 나 무료판의 Interbase 을 사용하시오 . 

- Unix/Linux 에서 플라그인구축방법 

다음은 Interbase 혹은 Firebird 가 /opt/interbase 에 설치된것 을 전제 로 한다 . 
cd $QTDIR/plugins/src/sql 구동프로그람 s/ 比 ) ase 

qmake -o Makefile "INCLUDEPATH+=/opt/interbase/include" "LIBS+=- 
L/opt/interbase/lib" ibase.pro 
make 

- Windows 에서 플라그인구축방법 

다음것은 Interbase 나 Firebird 가 C:\interbase 에 설치된것을 전제 로 한다 . 
cd %QTDIR%\plugins\src\sql 구동프로그람 sVbase 

qmake -o Makefile "INCLUDEPATH+=C ： \interbase\include" ibase.pro 
nmake 

Microsoft 롬파일 러 를 사용하지 않는다면 우의 문에 서 nmake 를 make 로 교체 한다 . 




C:\interbase\bin 가 PATH 에 있어 야 한다. 

3) 주의할 점 

자기 프로젝트에 사용하고있는 름파일러로 름파일한 의뢰기서고를 항상 리용하여야 
한다. 의뢰기서고들을 름파일하기 위한 원천배포물을 얻을수 없다면 사전를파일된 서고 
가 자기 콤파일 러 와 호환성있는가 확인하여 하며 그렇 지 않으면 많은 "undefined 
symbols " 오유를 엄을수 있다. 일부 름파일러는 서고를 변한하기 위한 도구들을 가지고 
있다. 실례로 Borland 는 Microsoft Visual C ++ 로 생성한 서고들을 변환하기 위한 도 
구 C0FF20MF.EXE 를 적 재한다. 

플라그인의 름파일 에 서 성 공하였지 만 적 재할수 없으면 다음의 요구가 만족되 는가 
확인 한다. 

•공유 Qt 서고를 리용하고있는가 확인한다. 플라그인들을 정적구축에 사용할수 없다. 

• 환경변수 QTDm 가 정 확한 등록부를 가리 키 는가 확인한다. 

$QTDIR/plugins/sqldrivers 등록부로 가서 그 등록부에 플라그인이 존재하는가 확인한다. 

• DBMS 의 의뢰기서고가 체계에서 사용할수 있는가 확인한다. Unix 에서 지령 ldd 
을 실행 하고 파라메 터로서 플라그인이름을 넘긴다. 실례로 ldd libqsqlmysql.so. 임의의 의 
퇴기서고를 찾을수 없으면 경고를 엄을수 있다. Windows 에서 Visual Studio 의 의존 
관계추적기를 사용할수 있다. 

플라그인적재와 관련한 문제들이 발생하면 다음과 갈은 출력을 볼수 있다. 

QSqlDatabase warning ： QMYSQL3 구동프로그람 not loaded 

QSqlDatabase ： available 구동프로그람 s: QMYSQL3 

문제는 플라그인이 틀린구축건이 있는것이다. 오유수정목적에서는 

$ HOME /. qt / qt _ plugins _( qtversion ). rc 파일 에 대 응하는 항목을 삭제 한다. 

이 플라그인을 다음에 적재할 때 더 자세 한 오유통보를 줄것 이 다. 

4) 자체의 자료기지구동프로그람을 쓰는 방법 

QSqlDatabase 는 자료기지 구동프로그람 플라그인들의 적재와 관리에 응답할수 있 
다. 자료기 지 가 추가되 면 ( QSqlDatabase : : addDatabase () 참고) 적 당한 구동프로그람 
플라그인이 적재된다 ( QSqlDriverPlugin 리용). QSqlDatabase 는 구동프로그람 플라그 
인에 기초하여 qsqldriver . html 과 qsqlresult . html 의 대변부를 제공한다. 

QSqlDriver 는 SQL 자료기 지 구동프로그람의 기 능을 정 의 하는 추상기 초크라스이 다. 
이것은 QSqlDriver :: openO 과 QSqlDriver : : close () 과 같은 함수들을 포함한다. 
QSqlDriver 는 자료기 지련결 에 응답하고 적 당한 환경 을 확립 한다. 또한 QSqlDriver 는 
특별 한 자료기지 API 에 적합한 QSqlQuery 객체들을 창조할수 있 다. QSqlDatabase 는 
구체 적 인 실현을 제 공하는 QSqlDriver 에 로의 직 접 함수호출을 촉진시 킨다. 

QSqlResult 는 SQL 자료기지 질문의 기 능을 정의하는 추상기 초크라스이 다. 이것은 
SELECT , UPDATE, 및 ALTER TABLE 과 같은 문들을 포함한다. QSqlResult 는 
QSqlResult ：： next (), QSqlResult : : valueO 와 같은 함수들을 포함한다. 
QSqlResult 는 자료기지에 질문보내기, 결과자료 돌려주기 등에 응답할수 있다. 
QSqlQuery 는 구체 적 인 실현을 제 공하는 " qsqlresult . html ” 에 로의 수많은 직 접 호출을 
촉진시킨 다. 

QSqlDriver 와 QSqlResult 는 밀접히 결합된다. Qt SQL 구동프로그람을 실현할 
때 두 콜라스는 파생콜라스화되여야 하고 각 들라스에서 추상가상메쏘드들이 실현되여야 
한다. 

Qt SQL 구동프로그람을 플라그인으로 실현하기 위하여(그것 이 실행 시 에 Qt 서 고를 
인식 하고 적 재하도록 하기 위하여 ) 구동프로그람은 Q EXPORT PLUGIN 마크로를 사용 
해야 한다. (자세 한 정보는 plugins - howto . html 을 읽으시오.) 또한 
QTDIR/plugins/src/sqldrivers 와 QTDIR/src/sql/drivers 에서 Qt 에 제공되는 SQL 플라그인들에 
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서 이것을 수행하는 방법을 검사한다 . 

다음의 코드는 SQL 구동프로그람의 골격으로 사용될수 있다 . 
class QNullResult : public QSqlResult 
{ 

public ： 

QNullResult( const QSqlDriver* d ) : QSqlResult( d ) {} 
〜 QNullResultO {} 
protected ： 

QVariant data( int ) { return QVariantO ； } 

bool reset ( const QString& ) { return FALSE ； } 

bool fetch( int ) { return FALSE; } 

bool fetchFirstO { return FALSE ； } 

bool fetchLastO { return FALSE ； } 

bool isNull( int ) { return FALSE ； } 

QSqlRecord record() { return QSqlRecordO; } 

int sizeO { return 0 ； } 

int numRowsAffected() { return 0 ； } 


class QNullDriver ： public QSqlDriver 

{ 

public ： 

QNullDriverO ： QSqlDriver() {} 

〜 QNullDriverO {} 

bool hasFeature( DriverFeature ) const { return FALSE ； } 
bool open( const QString 公 , const QString 技， const QString 技， 
const QString 技， int ) 

{ return FALSE ； } 
void close() {} 

QSqlQuery createQueryO const { return QSqlQuery( new 
QNullResult( this ) ) ； } 

}； 

제 6 절. 표모듈 

표모둘은 유연하고 편집가능한 표창문부품 QTable 을 제공한다 . 많은 응용프로그람 
들에서 QTable 은 직접 간단히 사용될수 있으며 살창모양의 편집가능세포들을 제공한다 . 
또한 QTable 은 간단한 방법으로 파생클라스화되여 대규모의 보기드문 표，실례로 수백 
만개의 세포를 가지는 표를 제공한다 . 
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그림 6-3. 표모듈 

표모듈은 다음과 같은 클라스들을 제공한다 . 

• QTable 자체 는 표계 산자료나 자료기 지자료와 같은 표형 식 자료를 현시 하고 편집 할 
능력을 사용자에게 제공해야 할 때마다 선택하는 창문부품이다 . 

• QTableltem 객체들은 세포의 내용을 보유하는 표의 매개 항목의 자료들로 
QTable 을 채우는데 쓰인다 . 

• QComboTableltem 콜라스는 QTable 들에 기 억 효과 복합칸항목들을 제공한다 . 

• QCheckTableltem 콜라스는 QTable 들에 기 억 효과 검사칸항목들을 제공한다 . 

• QTableSelection 은 QTable 안의 세포선택에 대한 접근을 제공한다 . 

• QHeader 는 표의 수평제목 ( 렬제목)과 수직제목 ( 행제목)에 대한 접근을 제공한다 . 

제7절. 작업공간모들 

작업공간모둘은 다중문서대면부 (MDI) 용의 장식된 문서창문들을 포함할수 있는 작 
업 공간창문을 제 공한다 . 

이것은 하나의 클라스 QWorkspace 에 의해 실현된다 . 

제8절. XML 모듈 


1. Qt 에서 XML 구성방식 

XML 모둘은 SAX2 (Simple API for XML) 을 리용하는 잘 형식화된 XML 문법해 
석기와 DOM Level 2 (Document Object Model) 의 실현을 제공한다 . 
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따른다 . 그 명명구조는 Qt 명명관례 에 맞게 채용되 였다 . 

SAX2 려과기와 읽기기구공장의 지원은 개발중에 있다 . Qt 실현은 Java 대면부에서 
시된 SAX1 호환콜라스들을 포함하지 않는다 . 

DOM Level 2 는 XML 문서의 요소들을 나무구조로 넘기는 XML 대면부용 W3C 권 
이다 . 

Qt 는 표 6-3 과 같은 XML 관련클라스들을 제공한다 . 


표 6-3. 

XML 관련클라스 

들라스 

간단한 설명 

QDomAttr 

QDomElement 의 한개 속성을 표시한다 . 

QDomCDATASection 

XML CD AT A 절을 표시한다 . 

QDomCharacterData 

DOM 안의 일 반문자렬 을 표시한다 . 

QDomComment 

XML 설 명 문을 표시한다 . 

QDomDocument 

XML 문서의 표시 

QDomDocumentF ragment 

보통 완전한 QDomDocument 이 아닌 QDomNode 들의 
나무 

QDomDocumentT ype 

문서나무에서 DTD 의 표시 

QDomElement 

DOM 나무의 한 요소를 표시한다 . 

QDomEntity 

XML 실 체 를 표시한다 . 

QDomEntity Reference 

XML 실 체참고를 표시 한다 . 

QDomlmplementation 

DOM 실현의 특성에 대한 정보 

QDomNamedNodeMap 

이름에 의해 호출할수 있는 마디집합 

QDomNode 

DOM 나무의 모든 마디들의 기초클라스 

QDomNodeList 

QDomNode 객체들의 목록 

QDomNotation 

XML 표기 법 을 표시한다 . 

QDomProcessinglnstructi 

on 

XML 처 리 지 령 을 표시한다 . 

QDomText 

문법해 석된 XML 문서의 본문자료를 표시한다 . 

QXmlAttributes 

XML 속성 

QXmlContentHandler 

XML 자료의 론리 적내 용을 알리 기 위 한 대 면부 

QXmlDeclHandler 

XML 자료의 선언내용을 알리기 위한 대면부 

QXmlDefaultHandler 

모든 XML 처 리 함수들라스들의 기 정 실 현 

QXmlDTDHandler 

XML 자료의 DTD 내 용을 알리 기 위한 대 면부 

QXmlEntityResolver 

XML 자료에 포함된 외 부실 체 를 해 결 하기 위한 대 면부 

QXmlErrorHandler 

XML 자료로서 오유를 알리 기 위한 대 면부 

QXmllnputSource 

QxmlReader 파생클라스용 입력자료 

QXmlLexicalHandler 

XML 자료의 어휘적내 용을 알리기 위한 대면부 

QXmlLocator 

파일안에서 문법해석위치에 대한 정보를 가지는 XML 처 
리 함수 클라스 

QXmlNamespaceSupport 

이름공간유지를 포함하려고 하는 XML 읽기기구용 방조들 
라스 

QXm 1 ParseException 

QXmlErrorHandler 대면부에서 오유통보에 사용한다 . 

QXml Reader 

XML 읽 기 기 구 (SAX2 문법 해 석 기 용 ) 의 대 면부 

QXmlSimpleReader 

간단한 XML 읽기기구 (SAX2 문법해석기용)의 실현 




2. Qt SAX2 콜라스들 

1) SAX2 

SAX2 대면부는 사건구동형기구로서 문서정보를 사용자에게 제공한다. 이 문맥에서 
《사건》은 문법해석기 에 의해 통보되는것을 의미한다. 례를 들면 문법해석기는 시 작꼬 
리표나 끝꼬리표 등과 만나게 된다. 

그것을 상상하기 위해 다음의 실례를 고찰한다. 

<quote>A quotation. < /quote 〉 

우의 문서를 읽을 때 (SAX2 문법해석기는 보통 《읽기기구》토서 서술된다) 3 개의 
사건들이 발생한다. 

① 시 작꼬리 표가 발생 한다 (<quote>). 

② 문자자료(즉 본문)가 발견된다 (’’A quotation."). 

4) 끝꼬리표가 해석된다 (< Aiuote >). 

그러한 사건이 발생할 때마다 문법해석기가 그것을 알리고 사건처리함수들을 설정 
하여 이 사건들에 응답한다. 

이것은 XML 문서를 읽어들이는 단순한 고속수법이지만 자료를 보관하지 않고 단순히 
처 리 하고 계 렬 적 으로 버리 므로 조작이 복잡해 진다. DOM 대 면부는 전체 문서 를 나무구조로 
읽고 보관하며 이것은 기억기를 많이 소비하지만 문서의 구조에 조작하기 쉽게 한다. 

Qt XML 모둘은 추상클라스 QXmlReader 를 제공하며 이 콜라스는 잠재적인 
SAX2 읽기기구용 대면부를 정의한다. 어는 읽기기구실현 QXmlSimpleReader 를 포함 
하며 이것은 파생클라스화를 받아들이기 쉽다. 

읽 기기구는 특수처 리 함수클라스들을 통하여 사건들의 해석정형 을 알린다(표 6-4). 


표 6-4. _특수처 리 함수클라스 


처리함수콜라스 

설명 

QXmlContentHandler 

문서의 내용(실례로 시작꼬리 표나 문자)과 관련한 사건들을 
보고한다. 

QXmlDTDHandler 

DTD (실례로 표기선언)와 관련한 사건들을 알린다. 

QXmlErrorHandler 

문법해석시 에 발생한 오유 혹은 경 고를 알린다. 

QXmlEntity Resolver 

문법해석시에 외부실체들을 알리며 사용자들은 그것을 읽기 
기구에 넘길 대신에 외부실체들이 자체로 해결하게 한다. 

QXmlDeclHandler 

기타 DTD 관련사건들(실례로 속성선언)을 알린다. 

QXmlLexicalHandler 

문서의 어휘구조 (DTD 의 시작, 설명문들 등)와 관련한 사 
건들을 알린다. 


이 콜라스들은 대면부를 서술하는 콜라스들이다. QXmlDefaultHandler 콜라스는 
그 모두에 대하여 《아무 일도 하지 않는》기정실현을 제공한다. 그러므로 작성자는 사 
탐들이 관심을 가지는 QXmlDefaultHandler 함수들을 재정의할 필요만 있다. 

XML 입력자료를 읽는데 특수콜라스 QXmllnputSource 가 쓰인다. 

이미 언급한것을 내놓고 표 6-5 와 같은 SAX2 지원클라스들은 추가적으로 유용한 기 
능을 제공한다. 


표 6-5. _ SAX2 지원콜라스 


클라스 

설명 

QXmlAttributes 

시 작요소사건의 특성 (attribute) 들을 넘 기 는데 쓰인다. 

QXmlLocator 

사건의 실제문법해석위치를 엄는데 쓰인다. 
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QXmlNamespaceSupp | 읽기기구용의 이름공간지원을 실현하는데 쓰인다 . 이름공간 
ort 은 문법해석동작을 변경하지 않는다 . 이름공간은 오직 처리 

_ 함수로부터 통보된다 . _ 


2) 기능 

XML 읽기기구의 동작은 일정한 선택적인 기능들에 대한 지원에 의존한다 . 실례로 읽 
기기구는〈〈꼬리표의 국부이름에 따라서 이름공간선언과 앞붙이들에 쓰이는 특성들을 알 
리는》기능을 가질수 있다 . 모든 다른 기능처럼 이것은 URI 에 의해 표시되는 유일이름 
을 가지며 그것을 http://xml.org/sax/features/namespace-preflxes 라고 부른다 . 

Qt SAX2 실현은 읽기기구가 QXmlReader::hasFeature () 함수를 사용하는 특별한 
기능을 가지는가 알릴수 있다 . 유효한 기능들은 QXmlReader::feature 0 에 의해 시험 
할수 있으며 QXmlReader： : setFeatureOi 의해 절환할수 있다 . 

실례를 고찰하자 . 

〈document xmlns：book = ’http://trolltech.com/fnord/book/’ 
xml ns = ’http://trolltech.com/fnord/’ > 

http : // xml. org/sax/features/namespace-prefixes 기 능을 지 원 하지 않는 읽 기 
기구는 요소이름문서를 알리지만 그 특성들 즉 xmlns:book 와 xmlns 의 값들을 알리지 
않는다 . 기능 http://xml.org/sax/features/namespace-prefixes 를 가지는 읽기기구 
는 그 기능이 설정되여있으면 이름공간속성을 알린다 . 

다른 기 능들로서 http : //xml. org/sax/features/namespace 

(http : //xml. org/sax/features/namespace-prefixes) 을 암시 하는 이 름공간처 리 와 
http://xml.org/sax/features/validation (유효화오유를 통보하는 능력)을 포함한다 . 

SAX2 은 사용자가 필요한 경우에 어떤 기능이든지 정의하고 실현하게 하며 
http : / / xml. org/sax/features/ namespace (와 

http://xml.org/sax/features/namespace-prefixes ) 는 필수적 이 다 . QXmlReader 의 
QXmlSimpleReader 실현은 그것들을 지원하며 이름공간처리를 수행할수 있다 . 

QXmlSimpleReader 는 유효화되 지 않으므로 http : / /xml. org/sax/features/validation 
를 지원하지 않는다 . 

3) 기능을 통한 이름공간유지 

앞에서 본바와 같이 이름공간처리할 때 읽기기구의 동작환경을 설정할수 있다 . 이것은 
http : / / xml. org/sax/features/namespaces 와 http : / / xml. org/ sax/features/namespace - 
prefixes 기능들을 설정 및 해제함으로써 수행된다 . 

그것들은 다음과 갈은 방법 으로 통보조작에 영향을 준다 . 

① 요소와 특성들의 이름공간앞붙이와 국부부분들을 통보할수 있다 . 

② 요소와 특성 들의 수식이 름들을 통보한다 . 

③ QXmlContentHandler ： : startPrefixMappingO 와 QXmlContentHandler ： : 
endPrefixMappingO 이 읽기기구에 의해 호출된다 . 

④ 이름공간을 선언하는 특성들(즉 특성 xmlns 와 xmlns : 로 시작하는 특성들)을 
통보한다 . 

다음의 요소를 고찰하자 . 

〈author xmlns：fnord = ’http://trolltech.com/fnord/’ 
title= ，， Ms ，， 

fnord : title: ’’Goddess ，’ 
name="Eris Kallisti ’’/〉 

http : // xml. org/sax/features/namespace-prefixes 를 TRUE 로 설 정 하면 읽 기 
기구는 4 가지 특성들을 통보하지만 namespace-prefixes 기능을 FALSE 로 설정 하면 3 
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가지만 알려주는것과 _ 함께 읽기기구에 《 보이지 않는》 이름공간을 정의하는 

xmlns:fnord 특성을 통보한다 . 

http://xml.org/sax/features/namespaces 란은 국부이름，이름공간앞붙이， URI 를 
알린다 . http://xml.org/sax/features/namespaces 를 TRUE 로 설정하면 문법해석기는 
仕 tie 을 fnord: title 특성의 국부이름으로서 , fnord 를 이름공간앞붙이로서 , 

http://trolltech.eom/:fnord/ 를 이름공간 URI 로서 알린다 . 

http://xml.org/sax/features/namespaces 가 FALSE 일 때 아무것도 통보하지 않는다 . 

현재의 실현에서 Qt XML 클라스들은 앞붙이 xmlns 자체가 어떤 이름공간과 전혀 련 
관되지 않는다는 정의를 따른다 .) 그러므로 http://xml.org/sax/features/namespaces 
와 http : //xml.org/sax/features/namespace-prefixes^- 둘다 TRUE 로 설정해도 읽기 
기구는 xmlns:fnord 에 대하여 국부이름 , 이름공간앞붙이 또는 이름공간 URI 를 돌려주지 
않는다 . 

이것은 xmlns 를 이름공간 http://www.w3.org/2000/xmlns 와 련관시키려는 
W3C 제안 http:/ 八 vww.w3.org/2000/xmlns/ 에 따라서 앞으로 변경될수 있다 . 

SAX2 표준이 제안하는것처럼 QXmlSimpleReader 는 기정으로 TRUE 로 설정된 
http://xml.org/sax/features/namespaces 와 FALSE 로 설정된 

http : //xml.org/sax/features/namespace-prefixes 를 가전다 . 

QXmlSimpleReader: :setFeature() 를 리 용하여 이 동작을 변경 할 때 FALSE 로 설정 
한 두 란의 결합은 옳지 않다 . 

2 개의 특별란이 읽기기구의 출력에 어떤 영향을 주는가를 실천적으로 보기 위하여 
특별 란실 례 를 가지 고 꼬리 표읽 기 기 구를 실 행 한다 . 


이상을 요약하면 QXmlSimpleReader 는 표 6-6 과 같은 동작을 실현한다 . 
표 6-6. __ QXmlSimpleReader 의 동작 


( 이름공간， 

이름공간앞불이 ) 

이름공간앞붙이와 
지역 부분 

수식 이 름 

앞붙이사영 

xmlns 

특성 

(TRUE, FALSE) 

Yes 

Yes* 

Yes 

No 

(TRUE, TRUE) 

Yes 

Yes 

Yes 

Yes 

(FALSE, TRUE) 

No* 

Yes 

No* 

Yes 

(FALSE, FALSE) 

Illegal j 


이 항목들의 동작은 SAX 에 의하여 지정되지 않는다 . 

4) 속성 

속성 (property) 은 더 일반적인 개념 이다 . 속성은 URI 로 표시되는 유일이름을 가 
지지만 그 값은 void* 이다 . 이와 근사하게 어떤 값이 속성값으로 사용될수 있다 . 이 개 
념은 위험성을 내포하며 형안전을 담보하는 수단도 없고 사용자는 그것들이 정확한 형을 
넘긴다는것 을 생각해 야 한다 . 속성은 읽기 기구가 특별한 처 리 함수클라스들을 유지 하는 
경우에 사용할수 있다 . 

특별란과 속성들에 사용된 URI 들은 URL (실례로 

http://xml.org/sax/features/namespace) 들과 같아보인다 . 이것은 요구되는 자료가 
이 주소에 있다는것을 의미 하지 않고 순수 유일 이름을 정의 하는 방법 이 다 . 

누구나 읽기기구용의 새 SAX2 속성들을 정의하고 사용할수 있다 . 속성유지는 필수 
적인것이 아니다 . 

속성들을 설정하거나 질문하기 위하여 다음의 함수들 즉 QXmlReader ： : setPropertyO, 
QXmlReader ： : property() 및 QXmlReader: :hasPror>ertyO 이 제공된다 . 
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3. Qt DOM 클라스들 
1) DOM 

DOM 은 XML 파일의 내 용과 구조를 호출하고 변경 하기 위한 대 면부를 제 공하며 문 
서의 계층보기 ( 나무보기)를 만든다 . 이처럼 SAX2 대면부와 대조되게 문서의 객체모형은 
조작을 간단하게 만드는 문법해석후에 기 억기 에 상주한다 . 

문서나무의 모든 DOM 마디들은 QDomNode 의 파생클라스이다 . 문서자체는 
QDomDocument 객체로 표시된다 . 

아래에 유용한 마디클라스들과 그 가능한 자식클라스들이 있다 . 

① QDomDocument ： 가능한 자식들은 다음과 같다 . 

QDomElement (대체로 하나 ) 

QDomP rocessinglnst ruction 
QDomComment 
QDomDocumentT ype 

② QDomDocumentFragment : 가능한 자식들은 다음과 같다 . 

QDomElement 

QDomP rocessinglnst ruction 
QDomComment 
QDomText 
QDomCDAT ASection 
QDomEntity Reference 

③ QDomDocumentT ype : 자식이 없다 . 

④ QDomEntity Reference: 가능한 자식들은 다음과 같다 . 

QDomElement 

QDomP rocessinglnst ruction 
QDomComment 
QDomText 
QDomCDAT ASection 
QDomEntity Reference 

⑤ QDomElement ： 가능한 자식들은 다음과 같다 . 

QDomElement 

QDomText 
QDomComment 
QDomP rocessinglnst ruction 
QDomCDAT ASection 
QDomEntity Reference 

⑥ QDomAttr ： 가능한 자식들은 다음과 같다 . 

QDomText 

QDomEntity Reference 

⑦ QDomP rocessinglnst ruction: 자식이 없다 . 

⑧ QDomComment ： 자식이 없다 . 

⑨ QDomText ： 자식이 없다 . 

⑩ QDomCDAT ASection: 자식이 없다 . 

⑪ QDomEntity ： 가능한 자식들은 다음과 같다 . 

QDomElement 

QDomP rocessinglnst ruction 

QDomComment 
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QDomText 
QDomCDATASection 
QDomEntityReference 
⑫ QDomNotation : 자식 이 없다 . 

QDomNodeList 와 QDomNamedNodeMap 라는 두개의 집합클라스가 제공된다 . 
QDomNodeList 은 마디들의 목록이고 QDomNamedNodeMap 은 순서화되지 않은 마디 
들의 모임이다 . 

QDomlmplementation 클라스는 DOM 실현의 특성을 사용자가 질문하게 한다 . 

4. 이름공간 

Qt XML 모둘문서의 부분들은 사람들이 XML 이 름공간을 알고있다고 가정한다 . 

이름공간은 XML 에 도입된 개념으로서 더욱 더 모둘적인 설계를 가능하게 한다 . 
이 름공간의 방조에 의해 자료처 리 쏘프트웨어 는 XML 문서 들에 서 이 름충돌을 간단히 해 결 
할수 있다 . 

다음의 실례를 고찰하자 . 

<document> 

<book> 

<title>Practical XML</title> 

〈author title="Ms" name="Eris Kallisti"/> 

〈 chapter 〉 

<title>A Namespace Called fnord</title> 

</chapter > 

■ 考 / book 〉 

</document> 

여기서는 이름 吐 tie 의 3 가지 각이한 사용을 볼수 있다 . 이 문서를 처리하려고 한다 
면 매개 title 이 같은 이름을 가지고있지만 각이한 방법으로 현시하여야 하므로 문제가 
생긴 다 . 

해결대책은 book 의 제목으로서 title 의 첫 출현을 식별하기 위한 수단을 가지고있 
어야 하는것이다 . 즉 book 이름공간의 title 요소를 사용하여 그것을 구별한다 . 실례로 
chapter 제목이 다 . 례를 들면 

<book : title>Practical XML</book ： title> 

이 경우에 book 는 이름공간을 표시하는 앞붙이 이다 . 

이름공간을 요소나 특성에 적용하기전에 그것을 선언해야 한다 . 

이름공간은 h1;tp://trolltech.com/fnord/b ⑴ k/ 와 같은 URI 이다 . 이것은 자료 
를 이 주소에서 사용할수 있다는것을 의미하지 않으며 URI 는 단지 유일이름제공에 쓰 
인다 . 

특성과 갈은 방법으로 이름공간을 선언한다 . 엄격히 말해서 속성은 특성이다 . 실례 
로 http://trolltech.com/fnord/ 을 문서의 기정 XML 이름공간 xmlns 로 만들기 위하 
여 다음과 같이 쓴다 . 

xmlns="http :// trolltech. com/ fnord/" 

http://trolltech.com/fnord/book/ 이름공간을 기정과 구별하기 위하여서는 앞붙 
이와 함께 그것을 써 야 한다 . 즉 

xmlns ： book= "http://trolltech.com/fnord/book/" 

이렇게 선언하는 이름공간은 적당한 앞붙이와 ":"구분기호를 앞에 련결하여 요소와 
특성이름들에 적용할수 있다 . book:title 요소에서 이것을 이미 보았다 . 

앞붙이 가 없는 요소이름들은 기정이름공간에 속한다 . 이 규칙은 특성들에 적용하지 
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못한다 . 앞붙이가 없는 특성은 선언된 XML 이름공간에 전혀 속하지 않는다 . 특성들은 
늘 그것들이 나타나는 요소의 《전통적인》이름공간에 속한다 . 《전통적인》이름공간은 
XML 이름공간이 아니며 이것은 단순히 어떤 요소에 속하는 모든 특성이름들이 달라야 
한다는것 을 의 미한다 . 후에 특성 에 XML 이 름공간을 할당하는 방법 을 보게 된 다 . 

앞붙이가 없는 특성들이 XML 이름공간이 아니라는 사실로 인하여 특성 title 
(au 比 Lor 요소에 속하는것 ) 과，실례로 chapter 안의 title 요소사이의 충돌은 없다 . 

실례를 통하여 이것을 명백히 하자 . 

〈document xmlns:book = ’http://trolltech.com/fnord/book/’ 
xmlns = ’http://trolltech.com/fnord/’ > 

<book> 

〈book : title>Practical XML</book : title〉 

<book：author xmlns：fnord = ’http://trolltech.com/fnord/’ 
title="Ms" 

fnord：title="Goddess" 
name="Eris Kallisti"/〉 

<chapter> 

<title>A Namespace Called fnord</title> 

</chapter > 

설/ book〉 

</document> 

document 요소안에서는 두개의 이름공간이 선언되 여있다 . 기정이름공간 
http://trolltech.com/fnord / 는 book 요소， chapter 요소，적당한 title 요소와 물론 
document 그 자체에 적용된다 . 

book ： author^ book:title 요소들은 URI http://trolltech.com/fnord/book/ 
를 가지는 이름공간에 속한다 . 

2 개의 book:author 특성 title 과 name 에는 할당된 XML 이름공간이 없다 . 그것들 
은 오직 요소 book ： author^ 《전통적인》이름공간의 성원일뿐이며 이것은 실례에서 
book:author 안의 두개 title 특성들이 금지된다는것을 의미한다 . 

우의 실례에서는 http://trolltech.com/fnord / 이름공간으로부터 book ： author ： 
에 title 특성을 추가함으로써 마지막 규칙을 우회하며 打 lord: 吐 tie 은 book:au 比 ior 요소 
에서 선언되는 앞불이 fnord 를 가지는 이름공간으로부터 온다 . 

명백히 打 lord 이름공간은 기정이름공간으로서 같은 이름공간 URI 을 가전다 . 그러면 왜 
이미 선언한 기정이름공간을 단순히 사용하지 못하는가 ? 그것은 아주 복잡하기때문다 . 

• 앞붙이를 가지는 특성들은 XML 이름공간에 전혀 속하지 않으며 지 어 기정이름공 
간에도 속하지 않는다 . 

• 또한 앞붙이의 생 략은 title-title 충돌을 가져온다 . 

• 그것을 xmlns:title 과 같이 쓰면 기정이름공간 xmlns 를 적용할 대 신에 앞붙이 
仕 tie 를 가지고 새 이름공간을 선언한다 . 

Qt XML 콜라스들에서 요소와 특성들은 두가지 방법으로 호출할수 있다 . 즉 이름공 
간앞붙이와《실제》이름(또는 국부이름)으로 이루어지는 수식이름들을 참고한다 . 국부 
이름과 이름공간 URI 를 결합하여 호출할수 있다 . 

XML 이 름공간에 대 한 자세 한 정 보는 http://www.w3.org/TR/REC-xml_ 
names / 에서 찾아볼수 있다 . 

- Qt XML 문서 에 서 사용하는 관례 들 

다음의 용어 들은 이 름공간문맥안에 서 이 름부분을 구별하는데 쓰인 다 . 

• 수식 이름 (qualified name ) 은 문서에 나타나는것과 같은 이름이 다 . (우의 실례에 
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서 book:title 는 수식 이 름이 다 . ) 

• 수식 이름에서 이름공간앞붙이 (namespace prefix) 는 ": "의 왼쪽부분이 다 . 

(book 는 book:title 에 서 이 름공간앞붙이 이 다 . ) 

• 이름의 국부부분(또는 국부이름으로 언급된다.)은 ”:”의 오른쪽에 나타난다. (따 
라서 title 은 book:title 의 국부부분이다.) 

• namespace URI ("Uniform Resource Identifier") 은 이름공간의 유일식별자 
이다 . 이것은 URL (실례로 http://trolltech.com/fnord/ ) 과 같아보이지만 주어진 
통신규약에 따라 이름있는 주소에서 자료를 호출할수 있게 되는것을 요구하지 않는다 . 

”: ’’이 없는 요소들(실례에서 chapter) 은이름공간앞붙이를 가지지 않는다 . 이 경우 
에 국부부분과 수식 이 름은 동등하다(즉 chapter). 

5. Qt XML 클라스들에서 SAX 2 기능의 사용실례 

이 절은 XML 의 이름공간과 SAX2 문법해석 기의 개 념을 알고있는것 을 전제 로 한다 . 
여 기서는 두가지 문제 즉 SAX2 기능을 설정하는 방법 과 Qt XML 기능을 Qt GUI 
응용프로그람에 통합하는 방법을 설명한다 . 

결과로 생기는 응용프로그람은 두개의 기능 http : //xml.org/sax/features/namespace- 
prefixes 와 http://xml.org/sax/features/namespaces 이 어떻게 설정되는가에 따라 읽기기구 
의 출력을 비교하게 한다 . 그러기 위하여 요소들의 수식이름과 특성들，각각의 이름공간 URI 들 
을 렬거 하는 XML 읽 기 파일 의 나무보기 를 표시 한다 . 

1) 기능설정 

응용프로그람의 기본프로그람으로부터 시작하자 . 우선 필요한 모든 클라스들을 포 
함한다 . 

#include "structureparser. h" 

#include <qapplication.h> 

#include <qfile.h> 

#include <qxml.h> 

#include <qlistview. h> 

#include <qgrid.h> 

■elude <qmainwindow. h> 

#include <qlabel.h> 

structureparser. 느는 structureparser. epp 에서 실현 하는 XML 문법 해석 기의 

API 를 포함한다 . 

int main( int arge, char **argv ) 

{ 

QApplication app( arge, argv ); 

보통처 럼 그다음 Qt 응용프로그람객 체를 창조하고 지 령행 인수들을 거기에 넘긴다 . 

QFile xmlFile( arge == 2 ? argv [1] : "fnord.xml" ); 

사용자가 인수로서 한개의 파일이름을 가지고 프로그람을 실행하면 파일을 처리하 
고 그렇지 않으면 example 등록부로부터 fnord.xml 파일을 사용한다 . 

QXmllnputSource source ( SxmlFile ); 
xmlFile 을 XML 입력원천으로 사용하며 

QXmlSimpleReader reader； 

reader 객체의 실례를 만든다 . 후에 그 기능들을 조작하여 XML 자료를 읽어들이는 
방법 에 영 향을 준다 . 

QGrid * container = new QGrid ( 3 ); 

그러면 출력현시에 대하여 고찰하자 . http://xml.org/sax/features/namespace- 
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prefixes 과 http : // xml. org/sax/features/namespaces 의 3 가지 유효결 합 즉 
TRUE/TRUE, TRUE/FALSE 및 FALSE/TRUE 가 있다 . 관련한 출력을 나란히 표시하 
고 그것들을 3 가지로 표식하기 위하여 3 개 렬과 두 행으로 이루어지는 살창배치관리자를 만 
든다 . 

QListView * nameSpace = new QListView ( container, 

"table_namespace” ) ； 

XML 요소들을 표시하는 가장 자연스러운 방법은 나무이다 . 따라서 목록보기를 사 
용한다 . 그 이 름 nameSpace 는 이 것 이 QXmlSimpleReader 의 기 정 환경 구성 인 
http :/ /xml.org/sax/features/namespaces 가 TRUE, http :// xml.org/sax/ 
features/namespace-prefixes^} FALSE 인 결 합을 표시 하는데 쓰인 다는것 을 가리킨다 . 

첫 살창항목이 nameSpace 이므로 목록보기는 가상살창의 왼쪽웃구석에 나타난다 . 
StructureParser * handler = new StructureParser( nameSpace ) ； 

그다음 읽기기구에 의하여 읽어들인 XML 자료를 취급하는 처리함수를 창조한다 . 
주어진 처리함수클라스 QXmlDefaultHandler 가 읽기기구로부터 들어온 자료를 가지고 
아무일도 하지 않을 때 그것을 정확히 사용할수 없다 . 그대신에 그로부터 자체의 
StructureParser 를 파생시켜야 한다 . 

reader. setContentHandler( handler ) ； 

handler 는 읽기기구용 내용처리함수로 동작한다 . 편리상 오유처리함수를 등록하지 
않는다 . 이리하여 프로그람은 해석된 XML 문서에서 닫긴 꼬리표들을 놓치는 실례에 대 
하여 오유를 통보하지 않는다 . 

reader, parse ( source ) ； 

끝으로 읽기기구의 기정기능설정을 리용하여 문서를 해석한다 . 

QListView * namespacePrefix = new QList\T.ew(container, M table_namespace_prefix ,1 ); 

이제는 갈은 XML 입력원천을 다른 읽기기구설정을 리용하여 해석할 준비를 한다 . 
출력은 둘째 QListView, namespacePrefix 에서 제시된다 . 이것이 container 살창의 
둘째 성원일 때 살창 웃행의 중간에 나타난다 . 

handler - 〉 setListView( namespacePrefix ); 

그다음 handler 에 namespacePrefix 목록보기 안의 자료를 현시 할것 을 요구한다 . 
reader. setFeature ( "http : / / xml. org/sax/features/namespace-prefixes f, , 
TRUE ) ； 

이제는 reader 의 동작을 수정하고 h 竹 p://xml.org/sax/features/namespace - 
prefixes 를 기정의 FALSE 로부터 TRUE 로 변경한다 . 

h1:tp://xml.org/sax/features/namespaces 기능은 아직 기정설정값 TRUE 를 가진다 . 
source, reset 0 ； 

새로운 문법해석이 문서의 선두로부터 다시 시작하도록 만들기 위하여 입력원천을 
재설정해야 한다 . 

reader, parse ( source ) ； 

끝으로 변경된 읽기기구설정 (TRUE/TRUE ) 을 사용하여 XML 파일을 두번째로 해 
석 한다 . 

QListView * prefix = new QListView ( container, "table_prefix") ； 
handler->setListView ( prefix ) ； 

reader. setFeature( "http : // xml. org/sax/features/namespaces", FALSE ) ； 
source, reset 0 ； 
reader, parse ( source ) ； 

다음으로 오른쪽우의 목록보기를 준비 및 사용하여 

http : / / xml. org/sax/features/ namespaces 가 FALSE, 
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http://xml.org/sax/features/namespace-prefixes 가 TRUE 인 기능설정값을 리용 
하여 읽기기구결과들을 표시한다 . 

// namespace label 

(void) new QLabeK "Default : \nhttp : // xml. org/sax/features/namespaces : TRUE\n M 
"http : // xml. org/sax/features/namespace-prefixes : FALSE\n’’，container ) ； 

// namespace prefix label 

(void) new QLabel ( ”\nhttp : //xml. org/sax/features/namespaces : 

TRUE\n ，， 

’’http : / / xml. org/sax/features/namespace-prefixes : TRUE\n M , 

container ) ； 


// prefix label 

(void) new QLabel ( "\nhttp : / / xml. org/sax/features/ namespaces : 
FALSE\n M 

’’http : / / xml. org/sax/features/namespace-prefixes : TRUE\n M , 

container ) ； 

container 살창의 둘째 행은 우의 목록보기에 속하는 읽기기구설정을 표시할수 있는 
3 개의 표식자들로 채워진다 . 

app. setMainWidget ( container ) ； 
container->show () ； 
return app. exec() ； 

} 

Qt GUI 프로그람에 서 와 같은 살창은 응용프로그람의 기 본창문부품으로서 동작하고 
표시 된 다 . 그 후에 GUI 의 사건순환고리 에 들어간다 . 

2) 처 리 함수 API 

처 리 함수클라스 StructureParser 의 API 를 간단히 고찰하자 . 

#include <qxml. h> 

#include <qptrstack. h> 


class QListView ； 
class QListViewItem ； 
class QString ； 

class StructureParser ： public QXmlDefaultHandler 

{ 

아무것도 하지 않는 처리함수를 실현하는 QXmlDefaultHandler 클라스로부터 그것 
을 파생시킨다 . 
public ： 

StructureParser ( QListView * ) ； 

bool startElement( const QString&, const QString&, const QString& , 
const QXmlAttributes 技 ) ； 

bool endElement( const QString 技， const QString&, const QString& ) ； 
이것은 사실상 요구되는 기능만 간단히 실현한다 . 실례에서는 인수로서 QListView 
를 가지는 구성 자 , 요소시 작꼬리표들이 출현할 때 실행할 함수 (QXmlContentHandler 
로부터 계승 ), 그리고 완료꼬리표가 발생시키는 함수이다 . 

지금 실현해야 하는것은 내용조종이다 . 
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void setListView ( QListView * ) : 

또한 출력의 목록보기를 선택하는 함수를 가전다 . 
private ： 

QPtrStack<QListViewItem> stack ； 

기 억 기 에 모든 요소와 특성 을 보관하기 위한 객 체 모형 이 없는 SAX2 문법 해석기 를 
작성한다 . 그렇 지 만 요소와 특성 들을 나무구조로 현시하기 위하여 아직 은 닫겨 지 지 않은 
모든 요소의 궤적을 보관하여야 한다 . 

그러 기 위하여 QListltem 들의 LIFO 탄창을 사용한다 . 하나의 요소는 시 작꼬리 표가 
나타나고 탄창에 추가되고 완료타그가 해석되면 곧 삭제된다 . 

QListView * table ； 

}； 

이와는 별도로 현재 사용한 목록보기를 포함하는 성원변수를 정의한다 . 

3) 처 리 함수자체 

이제 는 API 를 정의하였으므로 관련한 함수들을 실현해 야 한다 . 

#include "structureparser. h" 

#include <qstring.h> 

#include <qlistview. h> 

StructureParser :: StructureParser ( QListView * t ) 

: QXmlDefaultHandlerO 

{ 

우선 인수로서 목록보기지적자를 가지는 구성자가 있다 . 
setListView ( t ) ; 

} 

여 기서 수행해 야 할 일은 사용하기전에 인수 QListView 를 준비하는것 이 다 . 이것 을 
setListView 0 함수를 가지 고 수행한다 . 

void StructureParser： : setListView ( QListView * t ) 

I 

table = t ； 

우선 인수를 보관한다 . 
table->setSorting ( -1 ); 

문서에 나타나는것처럼 요소들을 가령 자모순으로 분류하지 않고 렬거한다 . 그것은 
분류기능을 완전히 차단하기 위해서다 . 

table->addColumn( "Qualified name" ); 
table_>addColumn( "Namespace" ); 

} 

현재 목록보기 는 두개 의 렬 로 이 루어 진다 . 즉 하나는 요소 혹은 특성 의 수식이 름， 
다른 하나는 그 이름공간 URI. 렬들은 왼쪽에서 오른쪽으로 추가되고 인수로서 제목을 
가진 다 . 

이제는 XML 내용조종을 취급한다 . 

bool StructureParser ： : startElement( const QString 技 namespaceURI, 
const QString 技 , const QString& qName, const QXmlAttributes& attributes) 

{ 

우연히 요소의 시작꼬리표와 만날 때 처리함수는 실제 작업을 수행한다 . 
startElement 가 4 개의 인수를 가지고 호출되여도 오직 3 개의 궤적 즉 요소의 이름공 
간 URI, 수식이름 및 특성만 보유한다 . 요소에 할당된 이름공간이 없거 나 읽기기구의 
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기능설정이 처리함수에 이름공간 URI 들을 전혀 제공하지 않는다면 namespaceURI 는 
빈 문자렬을 포함한다 . 

변수를 둘째 인수에 대 입하지 않으며 요소의 국부이름에 흥미를 가지지 않는다 . 
QListViewItem * element ； 

요소가 발생 할 때마다 목록보기 에 표시 하기 위 하여 QListViewItem 변수를 정의 한다 . 
if ( ! stack. isEmptyO ) { 

QListViewItem *lastChild = stack, top ()- 〉 firstChild(); 

요소 stack 이 비 여있지 않는한 현재 요소는 탄창의 제 일 웃끝 요소의 자식 이 다 . 이 
처 럼 첫 렬 에 새 요소의 수식이 름 , 둘째 렬 에 그에 따르는 이 름공간 URI 를 가지 는 
QPtrSta 沈 : : stack.topO 의 자식으로 새 로운 QListViewItem 을 창조한다 . 

보통 QListViewItem 은 첫 자식으로 삽입된다 . 이것은 요소들을 반대순서로 엄는 
다는것을 의미한다 . 그러므로 우선 QPtrStack::stack.topO 요소의 마지막 자식을 람색 
하여 요소뒤에 삽입한다 . 

유효 XML 문서 에서 이 것은 문서의 뿌리 를 제외한 모든 요소에 적 용한다 . 
if ( lastChild ) { 

while ( lastChild->nextSibling () ) 
lastChild = lastChild->nextS 比 ) lingO ; 

} 

element = new QListViewItem ( stack, top (), lastChild, qName, 
namespaceURI ) : 

} else { 

element = new QListViewItem ( table, qName, namespaceURI ); 

} 

뿌리요소는 QListViewItem 탄창에 넘겨야 할 첫 요소이므로 따로 조종해야 한다 . 
그 목록보기항목은 table 목록보기 자체의 자식 이 다 . 
stack, push ( element ); 

이제는 탄창꼭대기에 요소의 목록보기항목을 넣는다 . 
element->setOpen ( TRUE ); 

기정으로 QListView 는 닫긴 마디들을 모두 표시한다 . 그다음 사용자는 +그림기호 
를 찰칵하여 자식항목들을 볼수 있 다 . 

그러 나 프로그람을 실행할 때 전체 요소나무를 한번에 보려 고 하므로 매 개의 목록보 
기 항목을 수동적 으로 연다 . 

if ( attributes, length() > 0 ) { 

요소가 특성을 가진다면 어떻게 하겠는가 ? 

for ( int i = 0 : 1 < attributes, length() : i++ ) { 

new QListViewItem( element, attributes.qName(i), attributes.uri 必 ); 

} 

} 

그 매개 에 대 하여 새 로운 목록보기항목을 창조하여 특성의 수식이름과 관련이름공 
간 URI 들을 표시한다 . 명백히 attribute 는 현재 element 의 자식이다 . 
return TRUE ； 

} 

읽기기구에서 오유의 발생을 방지하기 위하여 요소의 시작꼬리표를 성공적으로 취 
급할 때 TRUE 를 돌려주어 야 한다 . 

bool StructureParser： : endElement( const QStringS, const QString 技， 
const QStringS ) 
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{ 

stack, pop 0; 

요소의 닫긴 꼬리표를 만날 때마다 더는 자식이 없으면 탄창에서 목록보기항목을 
삭제해 야 한다 . 

return TRUE ； 

} 

이로서 완료한다 . 

6. Qt SAX 2 콜라스들의 사용례- 아주 작은 문법해석기 

여기서는 지령행에 XML 문서의 모든 요소의 이름을 출력하는 작은 실례읽기기구를 
보여준다 . 요소이름은 그 겹쌓임준위 에 대응한다 . 

우리가 관심을 가지는 처리함수들라스들의 3 개 함수 즉 

QXmlContentHandler :: startDocument () , QXmlContentHandler :: startElementO 그리 
고 QXmlContentHandler: :en<iElement () 를 실현해 야 한다 . 

이를 위 하여 QXmlDefauUHandler 의 파생클라스를 사용한다 . (특수한 처 리 함수콜 
라스들은 모두 추상적 이 고 기정처 리 함수콜라스는 문법 해석동작을 변경 하지 않는 실현을 
제공한다 .) 

#ifndef STRUCTUREPARSER_H 

#define STRUCTUREPARSER_H 


^include <qxml.h> 
class QString ； 

class StructureParser : public QXmlDefauUHandler 

{ 

public ： 

bool startDocument () : 

bool startElement( const QStringS, const QString 技 ， const QStringS , 
const QXmlAttributes& ) : 

bool endElement( const QString&, const QString&, const QString& ); 
private ： 

QString indent; 

}； 

#endif 

정확한 들여쓰기를 얻는데 사용하는 비공개보조변수 indent 를 제외하면 새로운 
StructureParser 콜라스에서 특별한것은 없다 . 

실현은 간단하다 . 

#include "structureparser. h" 

#include <stdio. h> 

#include <qstring.h> 

우선 QXmlContentHandler::startDocument0 를 재정의한다 . 
bool StructureParser :: startDocument () 


indent = ""； 
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return TRUE ； 

} 

문서의 선두에서는 들여쓰기없이 뿌리요소를 출력하기 위하여 단순히 indent 를 빈 
문자렬로 설정한다 . 또한 문법해석기가 오유를 통보하지 않고 계속하도록 TRUE 를 돌 
려 준다 . 

문법해석 기 가 요소의 시 작꼬리 표를 만나서 그것을 출력할 때 통보하기 위하여 
QXmlContentHandler: :startElement () 를 재정의해 야 한다 . 

bool StructureParser： : startElement( const QString 技 , const QStringS, 
const QStringS qName, const QXmlAttributes& ) 

{ 

printf( "%s%s\n", (const char*)indent, (const char*)qName ); 
indent += " "； 
return TRUE ； 

} 

앞에 들여쓰기가 있는 이름뒤에 행중지가 출력된다 . 엄격히 말해서 qName 은 이름 
공간을 표시하는 마지막 앞붙이가 없는 국부요소이름을 포함한다 . 

또 하나의 요소가 현재요소의 완료꼬리표앞에 있다면 그것은 들여써야 한다 . 그러 
므로 indent 문자렬에 4 개의 공백을 추가한다 . 

끝으로 문법해석 기 가 오유없이 계속하도록 하기 위하여 TRUE 를 돌려준다 . 

마지 막으로 추가해 야 할 기능은 완료꼬리 표가 발생할 때 문법 해석 기의 동작이 다 . 
이것은 QXmlContentHandler::endElement () 의 재정의를 의미한다 . 

bool StructureParser ： : endElement( const QStringS, const QStringS, 
const QString 技 ) 

{ 

indent, remove ( (uint)O, 4 ); 
return TRUE ； 

} 

그때 명백히 startElementO 에 추가한 4 개의 공백만큼 indent 문자렬이 줄어들어 
야 한다 . 

문법해석기를 실현하였으므로 main 0 프로그람을 쓸수 있다 . 

#include "structureparser. h" 

#include <qfile. h> 

#include <qxml. h> 

#include <qwindowdefs. h> 


int main( int argc, char **argv ) 

{ 

if ( argc < 2 ) { 

fprintf( stderr, "Usage ： %s <xmlfile^ |<xmlfile> …] \n", argv[0] ); 
return 1 ； 

} 

이 검사는 지령행으로부터 시험하려는 파일들의 렬을 얻을수 있다는것을 담보한다 . 
StructureParser handler ； 

다음 걸음은 StructureParser 의 실례를 창조하는것이다 . 

QXmlSimpleReader reader ； 

reader. setContentHandler( ^handler ); 
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그다음 읽 기 기 구를 설정 한다 . StructureParser 클라스가 QXmlContentHandler 
기능을 취급할 때만 그것을 우리가 선택한 내용처리함수로서 등록한다 . 
for ( int i=l; i < argc ； i++ ) { 

지령행인수로서 주어진 모든 파일들을 성과적으로 취급한다 . 

QFile xmlFile( argv [i] ) ； 

QXmlInputSource source ( 技 xmlFile ) ； 

그다음 문법해석하려는 XML 파일용의 QXmllnputSource 를 창조한다 . 

reader, parse ( source ) ； 

이제는 입력원천을 가지고 문법해석을 시작한다 . 

} 

return 0 ； 

} 

다음의 XML 파일에 대 하여 프로그람을 실행하면 
〈 animals 〉 

〈 mammals 〉 

〈 monkeys 〉〈 gorilla/ 〉 <orangutan/> </monkeys> 

</mammals> 

<birds> <pigeon/> <penguin/> </birds> 

〈 /animals 〉 

다음의 출력을 생성한다 . 
animals 
mammals 
monkeys 
gorilla 
orang-utan 
birds 
pigeon 
penguin 

그러나 실례로 자기의 XML 시험파일안에서 <와 요소이름사이에 공백을 삽입하면 
정 확한 결과를 생성하지 않는다 . 이것을 방지 하기 위 하여 늘 

QXmlReader::setErrorHandler () 를 사용하는 오유처리함수를 설치해야 한다 . 이것은 
사용자에 게 문법 해 석 오유들을 통보한다 . 
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제 7 장. 국제화 


제 1 절 . (가에 의한 국제화 

응용프로그람의 국제화는 여러 나라 사람들이 응용프로그람을 사용할수 있게 하는 
과정 이 다 . 

일부 경우에 국제화는 쉽다 . 실례로 오스트랄리아 혹은 영국사용자가 호출할수 있 
는 미국응용프로그람제작은 얼마간의 철자수정만을 하면 된다 . 그러나 일본사용자들이 
사용가능한 미 국응용프로그람，도이 월 란드사용자들이 사용가능한 조선 응용프로그람작성 
은 쏘프트웨어 가 여 러 가지 언어 에서 조작할뿐아니 라 여 러 가지 입 력수법 , 문자부호화와 
표시관례를 사용할것을 요구한다 . 

Qt 는 개발자들이 불편없이 국제화를 가능하게 하려고 한다 . Qt 의 모든 입력창문부 
품들과 본문그리기메쏘드들은 모든 지원언어들을 위한 내부 (built-in) 기능을 제공한다 . 
내부서체엔진은 동시 에 여 러가지 문서체 계의 문자들을 담은 본문을 정확히，훌륭히 표현 
하는 능력 이 있다 . 

Qt 는 현재 쓰이고있는 많은 언어들을 유지한다 . 특히 

• 모든 동아시 아언어 ( 중국어，일어와 조선어 ) 

• 모든 서 유럽 언어 (라린어 사용 ) 

• 아랍어 

• 시 릴어 ( 토어 ) 

• 그리스어 

• 고대 헤 브라이 어 

• 타이와 라오스어 

• 특별한 처 리를 요구하지 않는 유니코드 3. 2 에서 모든 스크립트 

Windows NT/2000/XP 와 Xft (의뢰자측 서체지원)를 갖춘 Unix/Xll 에서는 다음 
의 언어들도 지원한다 . 

뱅 갈어， Devanagari, Dhivehi (Thaana) , Gujarati, Gurmukhi, Kannada, 
크레 르어 , 

말라이 어 (Xll 에서 만 ) , Myanmar (XII 에서 만)，수리 아어 , 타밀 어， Telugu, 리 베 
트어 (XII 에 서 만 ) 

다음 문서체 계들의 대부분은 구체적 인 특성들을 제시 한다 . 

•특별한 행중지조작 . 일부 아시아언어들은 단어들사이에 공백이 없이 쓴다 . 행중 
지는 중어，일본어와 조선어에서처럼(례외를 가지고 ) 매 문자뒤에 있을수 있고 혹은 타 
이어처럼 단어경계후에 있을수 있다 . 

• 쌍방향 쓰기 . 아랍어 와 고대 헤 브라이어 는 수자와 왼쪽에 서 오른쪽으로 쓰는 수 
자들과 영어를 제외하고 오른쪽에서 왼쪽으로 쓴다 . 

• 공백이나 구별표식없음(유럽언어들에서 악쎈트 혹은 모음변화 ). 일부 언어들은 
이 표식들을 광범히 사용하며 일부 문자들은 발음을 명백하게 하기 위해 한번에 한개이 
상의 표식을 할수 있다 . 

• 묶기 . 특수한 상황에 서 일부 문자쌍들은 묶기 (ligature) 를 형 성 하는 결 합된 글리 
프로 교체되였다 . 일반적인 실례는 미국식자판과 유럽문헌들에서 사용되는 fl 와 fi 묶기 
(ligature) 이 다 . 

Qt 는 우에서 렬거한 모든 구체적인 특성들에 주의를 돌린다 . 보통 Qt 의 입력창문 
부품들(실례로 QLineEdit, QTextEdit 과 파생콜라스들)과 Qt 표시창문부품들(례들어 
QLabel) 을 사용하는한 이 특성들에 대하여 걱정 하지 않아도 된다 . 
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이 문서 체계 에 대 한 지 원은 프로그람작성 자들에게 투명하며 완전히 Qt 본문엔진안에 
은폐된다 . 이것은 다음의 몇가지 경우를 제외하고 특별한 언어에서 사용되는 문서체계에 
대 한 지식 이 없어도 된다는것을 의미한다 . 

• QPainter ： : drawText( int x, int y, const QString &str ) 는 항상 x,y 파라 
메터에 의해 지정되는 위 치에 왼쪽끝을 맞춘 문자렬을 그린다 . 이것은 항상 왼쪽으로 정 
렬 된 문자를 준다 . 보통 아랍어 와 헤 브라이어 응용프로그람문자렬 들은 오른쪽끝에 맞추 
므로 이러한 언어들에서는 언어에 따라 맞추어쓰는 QRect 를 가지는 drawTextO 를 사 
용한다 . 

• 자체의 본문입력조종을 쓸 때 QFontMetrics::charWid 比 U) 를 사용하여 문자렬 
에서 한 문자의 폭을 결정한다 . 일부 언어들(아랍어 혹은 인디아지역의 언어들)에서 글 
리프의 너비와 형태는 주위문자들에 따라 변한다 . 입력조종을 쓸 때 보통 사용하려고 하 
는 스크립트에 대 한 일정한 지식을 요구한다 . 일반적 으로 가장 쉬운 방법은 QLineEdit 
혹은 QTextEdit 의 파생콜라스를 만드는것 이 다 . 

다음은 Qt 에서 지원하는 국제화 (il8n ) 의 상태들에 대한 정보를 준다 . 

또한 《 Qt 프로그람개발도구》 2 장을 참고할수 있다 . 

1. 절차 

Qt 에 의한 다중가동환경 국제 화쏘프트웨 어작성 은 유연하고 증분적 인 과정 이 다 . 生 
프트웨어 는 다음의 단계 들에 서 국제 화될 수 있 다 . 

1) 모든 사용자보임본문에서 QString 사용 

QString 은 내부적으로 유니코드부호화를 사용하기때문에 매개 언어는 비슷한 본문 
처리조작에 의하여 명백히 처리될수 있다 . 또한 사용자들에게 본문을 제시하는 모든 Qt 
함수들은 파라메터 로서 QString 을 가지 기 때 문에 char * 를 QString 으로 변환하기 위 한 
추가적인 작업이 없다 . 

《 프로그람작성자공간》 (QObject 이름과 파일형식화본문 등)에 있는 문자들은 
QString 을 사용할 필요가 없으며 전통적으로 쓰이는 char* 혹은 QCString 콜라스면 
중분하다 . 

유니코드를 사용한다고 알리는것 이 믿음직하지 않으면 QString 과 QChar 가 전통적 
인 C 의 조잡한 const char * 와 char 의 간단한 판들이 좋다 . 

2) 모든 리터럴본문에서 tr () 사용 

자기 의 프로그람이 사용자들에 게 현시할 본문으로써《 인용된 본문》을 사용할 때 마 
다 QApplication: translate 0 함수에 의 해 처 리 하는것 이 안전하다 . 이것을 달성하는데 
필수적으로 요구되는것은 QObject: :tr() 를 사용하는것이다 . 례 들어 Login Widget 가 
QWidget 의 파생들라스타고 가정하자 . 

Login Widget :: Login Widget () 

{ 

QLabel *label = new QLabel( trC'Password："), this ); 


만일 인용된 본문이 QObject 파생콜라스의 성원함수가 아니면 적당한 클라스의 
tr () 함수나 QApplication: : translate 0 함수를 직접 사용한다 . 
void some_global_function ( LoginWidget *logwid ) 

{ 

QLabel *label = new QLabel( LoginWidget: :tr("Password:”), 
logwid ) : 
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void same_global_function ( LoginWidget *logwid ) 

{ 

QLabel *label = new QLabel (qApp->translate ("LoginWidget", 

"Password："), logwid ); 

} 

만일 함수밖에서 본문을 완전히 번역하여야 한다면 그것을 방조하는 2개의 마크로 
가 있다. 그것들은 단지 아래에 서술한 A 썬 cfete 편의프로그람에 의해 추출본문을 표식한 
다. 마크로들을 본문으로 (문맥없이) 전개한다. 

QT_TR_NOOP() 의 실례: 

QString FriendlyConversation： : greeting ( int greet_type ) 

{ 

static const char* greeting_strings [] = { 

QT_TR_NOOP( "Hello" ), 

QT_TR_NOOP( "Goodbye" ) 

}； 

return tr< greeting_strings [greet_type] ); 

} 

QT_TRANSLATE_NOOP() 의 실례: 
static const char* greeting_strings [] = { 

QT_TRANSLATE_NOOp 7 "FriendlyConversation", "Hello" ), 
QT_TRANSLATE_NOOP( "FriendlyConversation", "Goodbye" ) 


QString FriendlyConversation： : greeting( int greet_type ) 

{ 

return tr( greeting_strings [greet_type] ); 

} 

QString global_greeting ( int greet_type ) 

{ 

return qApp->translate( "FriendlyConversation", greeting_strings[greet_type] )； 

} 

마크로 QT_NO_CAST_ASCII 정 의 를 가진 쏘프트웨 어 를 를파일 하여 const char* 
를 QString 으로 자_동변환§수 없으면 자기가 놓친 문자렬을 찾는것이 아주 좋다 
(QString: :fromLatin 1() 참고.) 변환을 허용하지 않으면 프로그람작성 이 좀 시끄러워 
진 다. 

자기의 원천언어 가 Latin-1 밖의 문자를 사용하면 QObject: :tr() 보다 
QObject: :trUtf8() 이 더 편리 하다는것을 알게 된다. tr() 는 

QApplication::defaultCodec() 에 의존되므로 QObject: :trUtf8() 보다 더 불리 하다. 

3) 지름값들에 QKeySequence 0 사용 

Ctrl+Q 혹은 Alt+F 와 같은 지름건값 (accelerator value) 들도 번역해야 할 필요가 
있다. 응용프로그람에 ’’Quit" 에 해당한 고정코드로 작성하면 번역기 

는 그것 을 무시할수 없 다. 정 확한 표현은 다음과 같다. 

QPopupMenu *file = new QPopupMenu( this );. 
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file->insertltem( tr("&Quit"), this, 

SLOT (quit ()), QKey Sequence (tr ("Ctrl+Q", "File | Quit")) )； 

4) 동적 본문에 QString： : arg 0 사용 

QString :: argO 함수는 인수를 대신하는 간단한 수단을 제공한다 . 
void FileCopier： : showProgress( int done, int total, const QStringS 



label.setText( tr("%l of %2 files 

copied. \nCopying ： %3"). arg (done). arg (total). arg(current_file) ); 

} 

일부 언어들에서 인수의 순서를 바꾸어야 할 때가 있는데 이것은 %인수들의 순서를 
바꿈으로써 쉽게 해결될수 있다 . 례들어 다음 

QString si = "%1 of %2 files copied. Copying: %3 "； 

QString s2 = "Kopierer nu %3. Av totalt %2 filer er 名 1 kopiert." : 
qDebug ( si. arg (5). arg (10). arg ("somefile. txt"). ascii () ) ； 
qDebug( s2. arg(5). arg(10). arg("somefile. txt"). ascii() ); 

은 영어와 노르웨이어로 정확한 출력문 

5 of 10 files copied. Copying : somefile. txt 

Kopierer nu somefile.txt. Av totalt 10 filer er 5 kopiert. 

을 생성 한다 . 

5) 번역문생성 

응용프로그람을 통해 tr() 를 사용하면 프로그람에 서 사용자보임 본문의 번역 생성을 
시작할수 있다 . 

《 Qt 도구의 사용법》 2 장에서는 어의 번역도구들인 Qt Linguist 과 1 update, 
lrelease 다 대 한 자세 한 정보를 제공한다 . 

Qt 응용프로그람의 번역은 3 단계로 이루어진다 . 

① lupdate 를 실행하여 Qt 응용프로그람의 C++ 원천코드로부터 번역해야 할 본문을 
끌어 내 고 번역기용통보파일 (.ts 파일)에 결과를 보관한다 . 이 편의프로그람은 tr() 구조와 
우에서 서술한 QT_*_NOOP 마크로들을 인식하여 .ts 파일들(보통 언어당 1 개씩)을 생성 
한다 . 

② QT Linguist 를 사용하여 .ts 파일에서 원천본문들을 위한 번역문을 제공한 
다 . .ts 파일들이 XML 형식으로 되여있으므로 자체로 편집할수도 있다 . 

③ lrelease% 실행하여 .ts 파일로부터 사용하는데 적합한 가벼운 통보파일 (.qm 파 
일)을 얻는다 . .ts 파일들을《원천파일》로서， .qm 파일들을《목적파일》들로 고찰한다 . 
번역 기는 .ts 파일들을 편집 하지 만 응용프로그람의 사용자들은 .Qm 파일들만 요구한다 . 
두 종류의 파일들은 가동환경과 지역에 의존하지 않는다 . 

일반적으로 응용프로그람을 개정할 때마다 이 단계들을 반복한다 . lupdate 편의프로 
그람은 앞선 출하물로부터 번역을 재사용하는데 제일 좋다 . 

HEADERS .ᄐ funnydialog. h \ 

wacky widget, h 

SOURCES = funnydialog. cpp \ 

main.cpp \ 
wacky widget, cpp 
FORMS = fancybox. ui 

TRANSLATIONS = superapp_dk. ts \ 
superapp_fi.ts 、 
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superapp_no. ts \ 
superapp_se. ts 

lupdate 나 lrelease 를 실행 할 때 지령행인수로서 프로젝트 파일의 이름을 주어야 한다. 

이 실례에서는 4 개 언어 즉 단마르크어, 핀란드어， 노르웨이어， 스웨리예어들이 
지원된다. qmake 를 사용하면 보통 lupdate 를 위한 특정한 프로젝트 파일이 필요 없고 
qmake 프로젝트 파일에 TRANSLATIONS 항목만 추가하면 잘 동작한다. 

응용프로그람에 서 는 사용자언 어 에 알맞는 번역 파일 들을 QTranslator: :load() 하고 
QApplication: :installTranslator() 를 리용하여 설치 해 야 한다. 

낡은 Qt 도구들 (findtr, msg2qm, mergetr) 을 사용하여왔다면 qm2t 를 사용하여 
낡은 .qm 파일들을 변환할수 있다. 

linguist, lupdate 그리고 lrelease 는 Qt 가 설치된 기초등록부의 bin 보조등록부에 
설치된다. Qt Linguist 에서 Help | Manual 을 선택하여 사용자지도서를 호출하면 여기 
에는 그 시작을 위한 지도서가 있다. 

이 편의 프로그람들은 .qm 파일들을 창조하는 편리한 방법 을 제 공하는 한편 .qm 파 
일들을 쓰는 체계면 충분하다. QTranslator : : insert 0에 의하여 QTranslator 에 번역 
문을 추가하는 응용프로그람을 만든 다음 QTranslator : : save 0에 의하여 .qm 파일들 
을 쓴다. 이 방법으로 번역문을 자기가 선택한 원천으로부터 꺼낼수 있다. 

Qt 자체는 목표언어들로 번역하는데 필요되는 400 개이상의 문자렬을 포함한다. 다 
른 언어로 번역하기 위한 형판뿐아니라 $QTDIR/translations 에서 프랑스어와 도이월 
란드 어용 번역파일을 볼수 있다. (이 등록부는 또한 유지되지 않지만 유용한 번역문을 
추가적으로 포함한다.) 

전형적으로 응용프로그람의 main 0 함수는 다음과 같다. 
int main( int argc, char **argv ) 

{ 

QApplication app( argc, argv ); 

// 이용 번역파일 

QTranslator qt( 0 ); 

qt. load( QStringC "qt_" ) + QTextCodec： : locale(), " ); 

app.installTranslator( &qt )； 

// 응용프로그람문자렬용 번역파일 

QTranslator myapp ( 0 ); 

myapp. load( QStringC "myapp_" ) + QTextCodec： ：locale0, " ); 

app.installTranslator( &myapp ) ； 


return app . exec 0 : 

} 

6) 부호화지 원 

QTextCodec 들라스와 QTextStream 을 사용하는 편의프로그람들은 사용자들의 자 
료에 대한 수많은 입력과 출력부호화를 쉽게 지원한다. 응용프로그람이 기동할 때 름퓨 
터가 있는 지역은 서체선택에서 본문표시 8 bit 본문입출력과 문자입력 등은 8 bit 자료를 
처 리할 때 사용되는 8 bit 부호화를 결정하게 된다. 

응용프로그람은 때때로 기정의 국부적인 8 bit 부호화가 아닌 다른 부호화를 요구할 
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수 있다. 례들어 Cyrillic KOI 8 -R 지역 (사실상 토씨 야의 표준지역)에서 응용프로그람은 
IS 08859-5 부호화의 씨릴 어 로 출력하여 야 한다. 

QString string = // 유니코드본문 

QTextCodec * codec = QTextCodec :: codecForName ( "ISO 8859-5" ); 

QCString encoded_string = codec->fromUnicode ( string ); 

... ； // use encoded_string in 8 bit operations 

유니코드를 국부적인 8 bit 부호화로 변환하는데 지름건이 쓸모있고 QString 의 
local 8 Bit () 메쏘드는 그러한 8 bit 자료를 돌려준다. 다른 유용한 지름건은 utf 8() 메쏘드 
인데 이것은 8 bit UTF -8 부호화로 된 본문을 돌려준다. 이것은 유니코드정보를 전적으 
로 유지하는 한편 본문이 완전히 US-ASCII 라면 일반 US-ASCII 처럼 보이게 한다. 

다른 변환방법 으로서 QString : : fromUtf 8() 와 QString : : fromLocal 8 Bit () 편의 함 
수들 혹은 일반코드가 있는데 그 코드를 ISO 8859-5 Cyrillic 로부터 유니코드에로의 
변환에서 보여준다: 

QCString encoded_string = // Some ISO 8859-5 encoded text . 

QTextCodec * codec = QTextCodec ： : codecForName ("ISO 8859-5") : 

QString string = codec->toUnicode ( encoded _ string ) : 

; // Use string in all of Qt’s QString operations . 

리상적으로 유니코드입출력장치는 세계의 여러 사용자들사이에 문서의 이식성을 최 
대화하기 위해 사용되지만 실제상 이것은 사용자들이 현존문서들을 처리할 필요가 있는 
적 당한 부호화를 모두 지 원하는것 이 유리하다. 일 반적 으로 유니 코드 ( UTF -16 혹은 
UTF -8) 는 임의의 사람들사이 에 정 보를 전송하는데 가장 유리하며 언어 혹은 민족집 단 
안에서는 국부표준화가 더 적합하다. 지원하여야 할 가장 중요한 부호화는 
QTextCodec : : codecForLocale () 가 돌려주는것 인데 이것은 사용자가 다른 사람들이 나 
응용프로그람들과 통신하는데 필요한것이다. (이것은 local 8 Bit () 에 의해 사용되는 
codec 이 다. ) 

Qt 는 더 빈번히 사용되는 부호화의 대부분을 원만히 지원한다 (QTextCodec 참고). 

일부 경우와 적게 사용되는 부호화를 위해 자체의 QTextCodec 파생들라스를 쓰는 
것이 필요하다. 긴급성에 따라서 1'1 > 011논6(：]1기술적지원을요구하거나(11；-11技6化31；우편목 
록에 부탁하여 그 부호화지원에 대하여 이미 동작하고있는가 확인한다. 림시대책은 
QTextCodec : : loadCharmapFile () 함수를 사용하여 자료구동형 codec 를 구축하는것 이 
다. 그러나 이 수법은 특히 동적으로 적재된 서고들에서 기억기와 속도에서 결함을 가진 
다. (자체의 QTextCodec 를 쓰는 방법은 QTextCodec 들라스를 참고하시오.) 

7) 국부화 

국부화는 지역적편리를 도모하는 처리로서 례들어 지역적으로 제기되는 형식화를 
리용한 날자와 시간표시를 들수 있다. 그러한 국부화는 적당한 tr () 문자렬을 사용하여 
달성할수 있다. 

void Clock : : setTime(const QTimeS t ) 

{ 

if ( trC ' AMPM ") == " AMPM " ) { 

// 12 시간 시계 
} else { 

// 24 시간 시계 

} 
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실례에서 영어를 사용하는 나라들에서 12시간단위의 시계를 사용하는것으로 보고 
( AMPM 》이 라고 번 역 하였지 만 유럽 에 서 는 그것 을 다르게 (어 떤곳에 서 는 《 EU 》 ) 번 
역하며 이것은 24시 간단위의 시 계를 코드에서 사용하게 한다. 

화상의 국부화는 권고하지 않는다. 지역사투리나 그에 맞는 은유에 기초하는것보다 
모든 지 역 들에 한해서 적 당한 지 우기 그림 기 호들을 선택 한다. 

2. 동적번역 

QT Linguist 와 같은 일부 응용프로그람들에서는 실행전기간 사용자언어선택의 변 
경 을 지 원할수 있어 야 한다. 체 계언어 변화를 알아야 할 매 개 창문부품에 는 
languageChangeO 라고 부르는 공개 처리 부를 실현한다. 이 처리 부에서는 보통 방법 으 
로 QObject::tr(){tr()} 를 사용하여 창문부품이 현시할 본문을 갱 신해 야 한다. 례 들어 

void My Widget :: languageChange 0 

titleLabel->setText(tr("Document Title")) ； 
okPushBu 竹 on->setText (tr ("&OK")) : 

} 

QWidget 파생 콜라스에 해 당한 기 정 사건처 리 함수는 LanguageChange 사건에 응답 
하며 필요할 때 이 처리부를 호출한다. 다른 응용프로그람부분품들은 창문부품들이 자체 
로 갱신하도록 이 처리부에 신호들을 련결할수 있다. 

3. 체계지원 

Qt 만이 동작하는 일부 조작체 계 와 창문체 계 들은 유니코드에 대 해 제 한된 기 능을 가진 
다. 기초하고있는 체계에서 유효한 지원의 수준은 일반적으로 Qt 응용프로그람들이 가동환경 
에 고유한제한과 관련되지 않아도 Qt 가이 가동환경들에 제공할수 있는지원에서 일정한영향 
을준다. 

1) Unix/Xll 

• 지 역 지 향 서 체 와 입 력 방식들. 어는 이 것 들을 숨기고 유니코드입출력 방식을 제 공한다. 

• UTF-8 과 같은 파일 체 계 관례 는 일부 Unix 변종들에 서 개 발중에 있 다. 모든 Qt 파일 함수 
들은 유니 코드를 허 용하지 만 국부적 8bit 부호화로 파일 이 틈을 변환하며 이 것 은 Unix 관례 이 다. 
(다른 부호화를 알려 면 QFile::setEncodingFunction() 을 참고하시 오.) 

• 파일 1/◦는 기 정 으로 QTextS 仕 earn 에 서 유니 코드선택 을 가지 는 8bit 부호화이 다. 

2) Windows 

• Qt 는 입 력 방법，서 체 , 오려 둠판, 끌어 다놓기 와 파일 이 틈을 비 롯하여 충분한 유니 코드지 
원을 제 공한다. 

• 파일 I/O 는 기 정 으로 QTextStteam 에 서 유니 코드선택 을 가지 는 Latin-1 이 다. 일 부 
Windows 프로그람들은 높은 수준의 규약이 없는것으로 하여 유니코드표준에 의해 서술되여있 
더 라도 비 그엔 디 안 유니 코드본문파일 들을 리 해 하지 못한다. 

• MFC 혹은 일 반 winlib 를 리 용하여 작성 한 프로그람들과 달리 Qt 프로그람들은 
Windows 95/98과 Windows NT 사이에서 이식할수 있다. 유니코드를 지원하기 위한 
다른 2진파일 들을 요구하지 않는다. 


4. XII 에서 지역에 대한 알아두기 

수많은 Unix 배포물은 일부 지역에 대한 부분적인 지원만 포함한다. 실례로 
/usr/share/locale/ja_JP.EUC 등록부를 가지고있으면 이것은 일본어본문을 현시할수 
있다는것을 의미하지 않으며 JIS 부호화된 서체들 (혹은 유니코드서체들)도 요구하며 
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/ usr / share / locale / ja _ JP.EUC 등록부는 완전성을 요구한다. 가장 좋은 결과들에 대하 
여서는 자기의 체계제작자로부터 받은 완전한 지역들을 사용한다. 

5. 관련한 Qt 들라스들 

다음의 클라스들은 Qt 응용프로그람들의 국제화와 관련되 여 있다. 


표 7-1. 

국제화관련콜라스들 

QBig 5 Codec 

Big 5 부호화에 대한 변환 

QEucJpCodec 

EUC-JP 문자모임 변환 

QEucKrCodec 

EUC-KR 문자모임 변환 

QGbl 8030 Codec 

중어 GB 18030 八} BK 7 GB 2312 부호화에 대한 변환 

QGb 2312 Codec 

중어 Chinese GB 2312 부호화에 대 한 변환 

QGbkCodec 

중어 Chinese GBK 부호화에 대한 변환 

QHebrewCodec 

시각적으로 순서화된 Hebrew 에 대한 변환 

QJisCodec 

JIS 문자모임에 대한 변환 

QSjisCodec 

Shift-JIS 에 대한 변환 

QTextCodec 

본문부호화사이의 변환 

QTextDecoder 

상태 해신기 

QTextEncoder 

상태 부호기 

QTranslator 

본문출력을 위한 국제화지원 

QT ranslatorMessage 

번역기통보문과 그 속성들 

QTsciiCodec 

타밀 TSCII 부호화에 대한 변환 


제2절. 유니코드 

유니 코드는 여 러바이 트문자모임 으로서 모든 주요 를퓨터 가동환경 에 서 이 식 가능하고 
세계의 대부분의 나라들에서 상당한 신용을 가지고있다. 또한 그것은 하나의 지역으로 
표시되며코드폐지 나 그밖의 복잡성을 가지지 않으므로 쏘프트웨 어를 쓰고 시험 하기 쉽게 
한다. 여러 가동환경에서 유니코드와 경쟁하는 문자모임은 없다. 이러한 리유로 
Trolltech 는 유니코드를 Qt (2.0 판부터)용의 원시적 인 문자모임으로서 사용한다. 

1. 웨브상에서 유니코드에 대한 정보 

유니코드협회 ( Consortium ) 는 사용가능한 수많은 문서를 가지고있다. 여기에는 다 
음과 갈은것들도 있다. 

• 유니코드에 대 한 기술적소개 

• 표준용 홈페 지 

2. 표준 

표준의 현재 판은 3. 2이 다 

• 유니코드표준， 3. 2.판. 

• 유니코드표준， 2.0 .판. 

3. Qt 에서 유니코드 

Qt 와 Qt 를 사용하는 대부분의 응용프로그람들에서 대부분 혹은 모든 사용자보임문 
자렬은 유니코드로 보관된다. Qt 는 다음과 같은것을 제공한다. 

• 파일 입 출력 을 위 한 유산부호화에 대 한 호상번역 (QTextCodec 와 QtextStream 
참고). 

•입력방식과 8 bit 건반입력으로부터의 번역. 
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• 화면상의 현시를 위하여 유산문자모임들로의 번역. 

• 문자렬클라스 QString 은 유니코드문자들을 보관하며 US - ASCII 에 대한 고속의 
(캐쉬된) 변환과 모든 보통문자렬조작을 비롯한 C 문자렬들로부터의 이식을 지원한다. 

• 적당한 유니코드인식창문부품들. 

• Windows 에서 유니 코드지 원 탐지，그러므로 Qt 는 본래 유니 코드를 유지하지 않고 
있는 Windows 가동환경에서도 유니코드를 제공한다. 

유니코드로부터 완전히 덕을 보기 위하여 사용자가 볼수 있는 모든 문자렬에 
QString 을 사용하고 QTextStream 을 사용하여 본문파일 입 출력 을 모두 수행할것 을 권 
고한다. 자기 가 작성하는 사용자정 의 창문부품들에서 건반입 력 에 QKeyEvent :: text () 를 
사용하면 서유럽 이 나 북미주의 느린 타자수들과 큰 차이는 없지만 textO 에 의한 특수입 
력 방식을 리 용하는 빠른 타자수들이나 사람들에게는 도움이 된다. 

어에서 사용자가 볼수 있는 문자렬인 모든 함수인수들， QLabel ：： setText () 및 그 
밖의 많은것들은 const QString & s 를 가진다. QString 은 다음과 같이 작업하는 
const char * 로부터의 암시적강제 변환을 제공한다. 
myLabel -> setText ( " Hello , Dolly !" ); 

또한 다음과 같이 번역을 제공하는 함수 QObject :: tr () 가 있다. 
myLabel -> setText ( trC ' Hello , Dolly !") ); 

tr () 는 const char *를 유니코드문자렬로 넘기며 설치 할수 있는 QTranslator 객체 
들을 사용하여 변환을 수행한다. 

어는 수많은 기본 QTextCodec 콜라스들 즉 유니코드와 유산부호화사이의 번역방 
법을 알고있는 클라스들을 제공한다. 이 콜라스들은 다른 프로그람들과 대화하거나 다른 
파일형식으로 과일들을 읽고 써야 하는 프로그람들을 지원한다. 

기정적으로 const char * 에 대한 변환은 지역에 의존하는 코드를 사용한다. 그러 
나 응용프로그람들은 다른 지 역 들의 코드를 쉽 게 찾아서 열린 파일 이 나 망련결 에 서 특수 
코드를 사용한다. 또한 기본코드들이 유지 하지 않는 부호화들에 새로운 코드들을 설치할 
수 있게 한다. ( Vietnamese 广 VISCID 그러한 실례의 하나이다.) 

US - ASCII 와 ISO -8859-1 가 아주 일반적이므로 그것들사이의 변환이 특히 빠른 
함수들이 있다. 실례 로 응용프로그람의 그림 기 호를 열기 위하여 다음과 같이 할수 있다. 

QFile f ( QString： : fromLatinl (" appicon . png ") ); 

출력에 관해서 Qt 는 유니코드로부터 체계와 서체가 제공하는 어떤 부호화로의 가장 
효과적인 변환을 수행한다. 조작체계，지역，서체리용가능성，사용하는 문자에 대한 Qt 
의 지원에 따라 이 변환은 좋을수도 있고 나쁠수도 있다. 가장 많이 사용하는 지역을 우 
선 강조하면서 앞으로 제공되는 판들에서 이것을 확장하려고 한다. 
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제 8 장. 이식과 가동환경 

제1절. 창문체계에 고유한 알아두기 

어는 여러 가동환경 GUI 도구일식이므로 대체로 전체 API 는 모든 가동환경과 창문체 
계 들에 서 갈다. 가동환경 에 고유한 특성 들을 사용하여 여전히 가동환경 에 의존하지않는 
원천 나무를 유지 관리하려 고 한다면 적 당한 # ifdef 문들을 리 용하여 가동환경 에 고유한 코 
드를 보호해야 한다. 

1. Qt/Xll 

이 가동환경에서 콤파일할 때 마크로 Q _ WS _ X 11 가 정의된다. 



표 8-1. _ Qt / Xll 서고의존관계 


이름 

서고 

설명 

Qt 

libqt 혹은 libqt-mt 

Qt ( libqt - mt 는 다중스레 드화된 다) 

Xft 

libXft 혹은 HbXft 2 

X Free Type Interface ； 一 xft 혹은 자•동 
탐지 

freetype 

libfreetype 

FreeType；-xft 혹은 자동탐지 

Xrender 

libXrender 

X 묘사확장; -xrender 혹은 -xft 혹은 자 
동람지 

Xinerama 

1 比 ) Xinerama 

다중스레드지원; -xinerama 혹은 자동탐지 

Xert 

libXext 

X Extensions 

Xll 

libXll 

X Window System 

GL 

libGL 

OpenGL ； 자동탐지(스레 드화되 면 -比 iread 
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이름 

서고 

설명 



를 요구) 

Xmu/Xt 

libXmu 와 libXt 

XX Toolkit 

SM 

libSM 

X Session Managementl -sm 

ICE 

libICE 

Inter-Client Exchange； -sm 

pthread 

libpthread 

다중스레드작성; -thread (OpenGL 이 스 
레드화되면 필요) 


알아두기 : 픽스매프와 화상들을 위한 알파투명도를 엄으려면 Xft 와 XRender 를 둘 
다 유지하고 를파일해야 한다. XRender 지원만 가지고 틈파일하는것으로는 충분하지 
않다. 

2. Qt/Windows 

이 가동환경 용으로 를파일할 때 마크로 Q _ WS _ WIN 이 정 의 된다. 

1) Microsoft Visual Studio 2005 전 개 문제 

Microsoft Visual Studio 2005 에서 름파일한 실행 파일들은 어와 응용프로그람자 
체가 의존하는 C / C ++ 실행시서고들을 지적하는 목록파일들을 요구한다. 목록 ( manifest ) 
파일은 자동적으로 생성되지만 실행가능프로그람과 같은 등록부에 배치되여야 한다. 

응용프로그람을 전개할 때 목록파일을 전개한다. 

알아두기: 자기 응용프로그람을 .manifest 파일로 전개하려고 하지 않는다면 mt 지령 
(Visual Studio 2005에 배포된다) 에 의 해 실행가능파일에 목록 ( manifest ) 을 자원으로 
묻어둘수 있다. 

다른 문제가 있으면 MSDN 문서 " Side - by-side Assemblies Reference ” 를 보시오. 

3. Qt/Mac OS X 

이 가동환경에서 를파일할 때 마크로 Q _ WS_MACX 가 정의된다. 

• Qt/Mac 문제 

4. Qt/Embedded 

이 가동환경 에 서 틈파일할 때 마크로 Q _ WS _ QWS 가 정 의 된다. (창문체 계 는 문자그 
대 로 Qt 창문체 계 이 다. ) 

• 설치 

• Qt/Embedded 성 능동조 

• Qt/Embedded 응용프로그람의 실행 

• Qt/Embedded 에로 자기 응용프로그람의 이식 

• 서체 형식과 정의 

• 문자입력 (건반，펜， ...) 

•위치지정장치조종 (마우스，펜, ...) 

• 기능정의파일을 가지고 기억기사용을 줄인다 
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제 2 절. Qt/Mac 문제 

이 파일 은 Qt 를 Mac OS 표에 서 사용할 때 의 알려 진 문제 점 들과 가능한 작업범 위 
를 륜곽적 으로 설 명한다. 

1. GUI 응용프로그람 

GUI 응용프로그람들은 widgets . app / 와 같은 묶음의 밖에서 혹은 open ( l ) 지령을 
리용하여 실행 하여 야 한다. Mac OS 표는 차림표띠 에로의 호출을 얻는것은 물론 사건들 
을 정 확히 발송하기 위하여 이것 을 요구한다. GDB 를 사용한다면 실행 가능파일에 로의 
완전경 로를 리 용하여 실행해 야 한다. 

2. QCursor 

Mac OS 표는 16 X 16 사용자정의유표만 가지므로 QCursor 는 이것에 의하여 제한 
된다. 현재 이 문제와 관련한 유일한 방법은 작은 유표 (16 X 16) 를 사용하는것 이 다. 

3. 반가명식 본문 

Qt/Mac (3.0.5 이상)는 Apple 의 Aqua Style 차림표에 따라 제 안된 본문을 위 한 
일부 기 능을 도입하였 다. 이 기 능은 Mac OS X >10.1.4 이 상으로 제 한되 고 이 판이 람 
색되지 않으면 낡은 본문묘사서 고로 넘어 간다. 

4. 서고유지 

1) 묶음 (bundle) 에 기 초한 서 고들 

동적 서 고들을 자기 의 Mac OS X 응용프로그람묶음의 부분(응용프로그람등록부) 으로 
서 결합하려면 이것들을 응용프로그람묶음의 보조등록부인 Frameworks 라는 등록부에 
배 치 한다. 

응용프로그람은 서고들이 8 executable _ path /.. / Frameworks / 1比) name . dyl 比)의 
설치이름을 가진다면 이 동적서고들을 발견한다. 

qmake 와 Makefile 을 사용한다면 QMAKE _ LFFLAGS _ SONAME 설정을 사용하여 
야 한다. 

QMAKE _ LFLAGS_SONAME = - W 1，- 

install _ name , 8 executable _ path /.. / Frameworks/Project Builder 의 경우에 Ubrary 목표들이 
9 executable _ patii /.../ Frameworks 로 설정된 자기의 설치경로(목표의 Build Settings 에서)를 
가지도록 설정 해야 한다. 또한 SKIP _ INSTALL 이라고 부르는 사용자정의구축설정을 추가하고 
이것을 YES 로 설정해야 한다. Application 목표에서 응용프로그람래퍼의 Framework 보조홀더 
에 로 서 고제 품을 복사하는 Copy Files 구축단계 를 추가해 야 한다. 

DYLD _ LIBRARY _ PATH 환경변수들이 이 설정을 무시하고 / usr/lib 및 류사한 
기정위치들안에서 동적국고들의 검색과 같은 다른 기정경로들로 설정된다는것을 알아야 
한다. 

아직도 서고코드가 Mac OS 표의 2진에 포함되는 정적응용프로그람들을 구축할것을 
강하게 권고한다. 그러나 플라그인기능을 요구하는 응용프로그람들을 싣는 경우에 동적 
서고들을 자기 응용프로그람의 부분으로 사용하여 야 한다. 

2) 서 고들의 결 합 

Qt 3.1 동적서고들을 결합하는 새로운 동적서고를 구축하려고 한다면 Id - r 기발을 
받아들여 재배치정보를 출력파일에 보관함으로써 이 파일이 다른 Id 실행의 주제로 되게 
할수 있다. 이것은 . pro 파일에 - r 기발을 설정하고 LFLAGS 설정에 의해 수행된다. 

3) 초기 화순서 

dyld ( l ) 은 대역정적초기화자들을 자기의 응용프로그람에 련결하기 위하여 그것들 
을 호출한다. 서 고가 Qt 에 련결되 고 Qt 에서 (자체 의 서 고에서 대 역 초기 화자들로부터 ) 대 
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역변수들을 참고한다면 자기 의 서 고보다 먼저 Qt 와 련결 하는가 확인해 야 하며 그렇 지 
않으면 Qt 의 대역초기화자들이 아직 호출되지 않았으므로 결과는 정의되지 않는다. 

4) 플라그인 기 능 

Project Builder 혹은 Xcode 를 리용하여 Qt 플라그인들을 구축할수 없다. qmake 
에 의해 환경을 구성하고 플라그인들을 구축한다. 

5. 를파일러설정 

- 롬파일시 기 발 

정의 에 특정한 Mac OS X 코드를 포함하려 고 한다면 다음과 같이 Q _ OS_MACX 기 
발을 사용한다. 

#if defined ( Q _ OS _ MACX ) 

// the code used 
#endif 

Mac OS X 10.2 하에서 구축할 때 MACOSX _102 기발이 자동적으로 make 구축에 
포함된다. 

6. Qt/Mac 의 구축 및 환경구성 

- 정적 환경 구성 문제 

정적서고가 designer make 단계에서 다음과 같은 오유로 실패하면 
QWidget :: sizeHint 0 const referenced from libqui expected to be defined 
in 8 executable _ path /.. / Frameworks / libqt - mt . 3 .dylib non-virtual thunk 
[ nv :_40] to QWidget :: metric ( int ) const referenced from libqui expected to 
be defined in 通 executable_pa 比!/. . / Frameworks /1 比) qt - mt . 3. dyl 比) 

자기의 서고경로가 1比 >qui 서고들 혹은 기호련결을 가지지 않는가 확인한다. 이것들 
을 삭제하면 구축은 계 속된 다. 

7. Macintosh Native API 호출 

1) 묶음경로의 호출 

Macintosh 응용프로그람은 실제로 .app 로 끝나는 등록부이다. 이 등록부는 여 러가 
지 다른 보조등록부들과 원천을 포함한다. 이 묶음안에 실례로 플라그인등록부를 배치하 
려고 한다면 묶음이 디스크의 어디에 상주하는지 알아야 한다. 다음의 코드는 이것을 수 
행 한다. 

CFURLRef pluginRef = 

CFBundleCopyBundleURL (CFBundleGetMainBundle ()) ； 

CFStringRef macPath = CFURLCopyFileSystemPath ( pluginRef , 
kCFURLPOSIXPathStyle ) : 

const char *pathPtr = CFStringGetCStringPtr ( macPath , 

CFStringGetSystemEncoding ()) : 

qDebugC'Path = % s ", pathPtr ); 

CFRelease ( pluginRef ) : 

CFRelease ( macPath ); 

#if defined ( Q _ OS _ MACX ) 마크로명령문안에 이것을 넣어야 한다. 

2) 응용프로그람 차<표와 원시 대 화칸의 번 역 

지역화된 응용프로그람 차림표와 원시대화칸을 얻으러면 약간한 작업을 해야 한다. 
이것은 Mac OS 표가 요구하는것이지 Qt 의 요구가 아니다. 

우선 지 역 화된 자원홀더를 Bundle 안에 추가해 야 한다. 

http : // developer , apple , com / documentation / CoreFoundation / Conceptual / 
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CFBundles / index , html 

그리 고 제목 Adding Localized Resources 를 찾는다. 

중요하게 할 일은 locversion . plist 라는 파일을 창조하는것이다. 여기에 노르웨이 
어의 실례가 있다. 

<?xml version ="1.0" encoding =" UTF -8"?> 

<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0// EN " 
" http :// www . apple . com / DTDs / PropertyList - l . 0. dtd "> 

성 plist version:" 1.0"> 

< dict > 

< key > LprojCompatibleVersion </ key > 

< string >123</ string > 

< key > LprojLocale </ key > 

< string > no </ string 〉 

< key > LprojRevisionLevel </ key > 

< string > l </ string 〉 

< key > LprojVersion </ key > 

< string >123</ string 〉 

</ dict > 

</ plist > 

그다음 자기 가 요구하는 언어로 응용프로그람을 실행할 때 노르웨 이 어로 설정 하여 
" Quit ” 대신에 ” Avslutt " 와 같은 차림표항목을 표시한다. 

8. 사용자대면부 

1) 오른쪽마우스찰칵 

Mac OS X 용으로 오른쪽마우스찰칵기능을 제공하려면 QContextMenuEvent 클라 
스를 사용한다. 이것은 상황차림표 다시 말하여 올리펼침선택을 현시하는 차림표로 변환 
된다. 이것은 오른쪽마우스찰칵의 가장 일반적인 사용이고 조종건-찰칵을 Mac OS 표의 
1단추마우스기능으로 변환한다. 

2) 차림 표띠 

Qt / Mac 는 자동적으로 자기의 차림표띠들을 탐지하고 그것들을 Mac 원시차림표띠 
들로 변환한다. 이것을 자기의 현존 Qt 응용프로그람에 적합하게 조절하는 조작은 보통 
자동적으로 진행되지만 특별한 요구가 있다면 현재 Qt/Mac 는 능동창문(즉 
QApplication : :크산卜6'界1]1<10'〜())으로부터 시 작하여 차림 표띠 를 선택 하고 다음과 같이 
적용한다. 

© 창문이 QMenuBar 를 가지면 그것 이 사용된다. 

② 창문이 이 행금지 이면 차림 표띠 가 사용된다. 차림표띠가 지정되지 않으면 기정차 
림표띠가 아래에 서술하는것처럼 사용된다. 

# 창문이 부모를 가지 지 않으면 기 정차림 표띠 가 아래 에 서 술하는것 처 럼 사용된 다. 
우의 세 걸음은 우의 하나가 만족될 때까지 부모창문사슬우의 모든 길에 적용된다. 
모두가 실패 하면 기 정차림 표띠 가 창조되 며 Qt / Mac 에 서 기 정 차림 표띠 는 빈 차림 표띠 이 
지 만 부모없 이 QMenuBar 를 창조함으로써 각이한 기 정차림 표띠 를 창조할수 있 으며 처 
음 창조된것은 기정차림 표띠 로 지정되 고 기정차림 표띠 가 요구될 때 마다 사용된다. 

9. 제한 

1) 차림표항목 

• QCustomMenuItems 은 Mac 원시 차림표띠들에 유지되지 않고 Mac 원시 차림표띠 
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에 없는 올리펼침차림표들에 유지된다. 

• 하나이상의 건치기 ( QKeySequence ) 를 가지는 지름건을 가진 항목들이 있으면 
처음건이 사용된다. 

2) 유지 되 지 않은 원시 창문부품들 

현재 Qt / Mac 는 속성지 ( sheet ), 그리기기구 ( drawer ) 혹은 선택기 ( chooser , 
Pan 比 ier 형 식 타브들)를 유지 하지 않는다. Qt 의 다음 판들에 서 이 것 들을 유지 할수 있 다. 
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제 9 장. Qt/Embedded 


제1절. Qt / Embedded 의 설치 

설치수속은 Linux 용으로 작성되고 다른 가동환경에서는 수정해야 한다. 

必 이미 수행 하지 않았으면 압축파일의 압축을 푼다. 
cd < anywhere > 

gunzip qt - embedded - commercial - VERSION . tar . gz # uncompress the 

archive tar xf qt - embedded - commercial - VERSION . tar # unpack it 

VERSION 을 Qt/Embedded 판번호로 완전히 교체한다. 

여기서는 압축파일가 ~/ qt - embedded - commercial-VERSION 으로서 설치된다는 
것을 가정한다. 

② Qt/Embedded 서 고와 실례들을 를파일한다. 
cd ~/ qt - embedded - commercial-VERSION 

export QTDIR =~/ qt - embedded - commercial-VERSION 

. /configure 

make 

환경구성체계는 가동환경에 고유한 선택들을 추가하도록 설계되지만 일반적으로 틀 
완충기를 유지하는 모든 Linux 체계는 " linux - generic - g ++" 가동환경을 사용할수 있다. 
또한 환경구성체계는 교차틈파일러를 유지하며 Linux / x 86 에서 Linux/MIPSEL 목표에 
대하여 구축하려면 다음과 같이 리용할수 있다. 

. /configure -embedded mips 

적은 수의 환경구성만 미리 정의된다. mkspecs / qws / 등록부에 새 파일들을 추가 
하여 자기 의 사용자정 의 환경 구성 을 창조할수 있 다. 출발점 으로서 류사한 현존환경 구성 을 
사용한다. 

알아두기 : 환경 구성 스크립 트에 서 오유로 인하여 리 틀엔 디안를퓨터(실 례 로 x 86) 에 서 
비 그엔 디 안처 리 소자(실 례 로 PowerPC ) 용으로 교차롬파일 할 때 목표대 신에 주름퓨터 의 
엔디 안성 을 사용한다. 주의 : configure 를 실행 한 후에 make 를 실행 하기 전에 
$ QTDIR / include / qconfig.h 를 편집 하고 Q _ BYTE_ORDER 의 정의 를 변경 한다. 

③ 틀완충기유지를 허용한다. 

틀완충기를 허용하도록 핵 심을 재틈파일할 필요가 있다. 여 기서는 그 수행방법 을 
서술하지 않으며 틀완충기 HOWTO 패지에는 간단한 설명이 있다. (틀완충기를 허용하면 
기동시 에 펭긴새로고가 보인다.) 

Matrox G 100/ G 200/ G 400 에서는 matrox 틀완충기 구동프로그람을 사용한다. 

NVidia TNT 카드에 서 는 nvidia 틀완충기 구동프로그람을 사용한다. 

Mach 64 와 대 다수 다른 카드들에서는 vesafb 구동프로그람을 사용한다. 

일부 카드는 VGA 16 방식에서만 유지되며 이것은 현재 판의 Qt/Embedded 에서는 
VGA /16 이 아직 유지되지 않았으므로 작업하지 않는다. 자기 핵 심을 갱신하거 나 지 어 
는 실험적핵심으로 절환할 필요가 있다. 

또한 틀완충기 는 boot 파라메터 에 의 해 허 용되 여 야 한다. (자세 한것 은 

/ ilsr / src / linux / Documentation/fb 를 참고하시 오. ) 

fbset 프로그람은 Linux 배포물에 포함되며 체계를 재기동하지 않고 비데오방식을 
절환하는데 쓰인다. 봉사기 가 기동할 때 능동으로 되는 비데오방식 이 사용된다. (8 bit 방 
식들은 여전히 실험적 이다. ) 

알아두기 : fbset 는 vesafb 구동프로그람과 작업 하지 않는다. 
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④ 허 가를 변경 한다. 

Qt/Embedded 를 실행하려면 틀완충장치 /dev/fbO. 에 대한 호출을 쓸 필요가 있다. 

또한 마우스장치에 대한 호출을 읽어들여야 한다. (보통 /dev/mouse 가 기호련결 
이 고 실제의 마우스장치 는 읽 기 가능이 여야 한다.) 

⑤ 실례프로그람을 실행하는 방법 

다음과 같이 가상콘솔로 가입하고 수행한다. 
cd ~ / qt-embedded-commercial-VERSION / examp 1 es/launcher 
. / start-demo 

⑥ 여 러 가지 난관을 알리는 오유들 

gpm 를 없애려면 루트로서 다음의 지령을 실행한다. 
gpm -k 

일부 경우에 봉사기가 작업하지 않으면 루트로서 실행할 때 그것이 작업한다. 

틀완충기를 사용하여 프로쎄스들을 보여준다. 
fuser -v /dev/fbO 

그러 한 프로쎄스들을 없앤다. 
fuser -vk /dev/fbO 

혹은 거슬러는것을 없앤다. 
fuser -k -KILL /dev/fbO 

현존 쎄마퍼를 보여준다. 
ipcs 

쎄마퍼들을 삭제한다. 
ipcrm 

의뢰기와 봉사기사이의 통신은 이름있는 파이프 / tmp/qtembedded-username/ 
QtEmbedded-0 를 통하여 수행되 고 흔히 그것을 삭제 하는데(실례 로 루트특권으로 
Qt/Embedded 를 실행한다면 후에 특권없는 사용자로서) 필요할수 있다. 

種) 전용화 

Qt/Embedded 서고는 불필요한 특성의 삭제 에 의 하여 크기를 줄일수 있 다. 

⑧ 개발과 오유수정을 위 하여 대신에 Qt/Embedded 가상틀완충기를 사용하는것이 
더 간단하다. 


제2절. 특성정의파일 

src/tools 로부터 환경파일 qconfig.h 를 수정함으로써 설치에서 사용하는 완전한 
Qt 기 능의 부분모임 을 정 의할수 있 다. 환경 에 대 한 -qconfig 선택 은 환경 구성 을 선택하 
는데 사용된다. 

이러한 수정은 Qt 의 크기를 줄이는것이 중요하고 응용프로그람설정이 자주 고정되 
는 Qt/Embedded 가동환경에서만 리용된 다. 

qconfig.h 정의파일은 특성들을 허용하지 않도록 마크로들을 정의한다. 일부 특성 
들은 다른 특성에 의존하며 이 의존관계는 qfeatures.h 에서 표시된다. 

유효선택은 표 9-1 과 같다. 


표 9-1. 

유효선택 


마크로 

금지 

다음에 의하여 자동 
설정 

화상 ( QlmagelO ) 

| QT_NO_IMAGEIO_BMP | 

Microsoft Bitmap 화상파일형 식 . 

1 
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QT_NO_IMAGEIO_PPM 


Portable Pixmap 화상파일 형 식 . 





QT _ NO _ IMAGEIO_XBM 

Xll Bitmap 화상파일형식 . 


QT _ NO _ IMAGEIO_XPM 

Xll Pixmap 화상파일형식. 


QT _ NO _ IMAGEIO_PNG 

Portable Network Graphics 화상 
파일형식. 


1 동화상 i 

QT _ NO _ ASYNC_IO 

비 동기 I /。 (QAsyncIO) 


QT _ NO _ ASYNC _ 

비 동기 화상 I/O 과 GIF 화상지 원 


IMAGE JO 

( QlmageDecoder , ...) 


QT _ NO_MOVIE 

동화지원 ( QMovie ) 

QT _ NO _ ASYNC_I 
O , QT _ NO_ASYN 
C _ IMAGE_IO 

i 서체 i 

QT _ NO_TRUETYPE 

TrueType ( TTF 와 TTC ) 서체파일 
형식. Qt / Emtedded 에서만 사용. 


QT _ NO_BDF 

Bitmap Distribution Format (B 
DF ) 서체 파일형식. Qt/Embedded 
에서만 사용. 


QT _ NO_FONTDA 

TABASE 

서 체 자료기 지 . 


국제화 

QT _ NO _ I 18 N 

유니코드와 8- bit 부호화사이의 변환. 


QT _ NO_UNICODE 

모든 유니코드문자 용 대소문자변 


TABLES 

환과 갈은것을 정의하는 대규모표. 


I MIME I 

QT _ NO_MIME 

형있는 자료 (실례로 본문，화상， 

색)의 부호화와 타그화용 Internet 
표준인 Multipurpose Internet M 
ail Extensions ( QMimeSource ) 


QT _ NO_RICHTEXT 

HTML 풍의 본문 ( QStyleSheet , 
QLabel ) 

QT _ NO_MIME 

QT _ NO 一 DRAGAND 

응용프로그람들사이 의 끌어 다놓기 

QT _ NO_MIME 

DROP 

자료 ( QDragObject ) 


QT _ NO_CLIPBOARD 

응용프로그람들사이의 자르기 및 
붙이기 ( QClipboard ) 

QT _ NO_MIME 

1 음성 1 

| QT _ NO_SOUND 

음성파일재생 ( QSound ) 

1 

I 스크립 링 1 


■벼 B 했 



265 



Qt/Embedded 에 고유 


QT _ NO _ QWS_CURSOR 

Qt / Embedded 에서 유표 sprite . 펜 
조작장치는 보통 이 특성을 요구하 
지 않는다. 


QT _ NO _ QWS _ DEPTH _ 

8 GRAYSCALE 

화소당 8 bit ： 재색의 256준위. 

(3광3_0표1 3 1^_8와 비호환. 


QT _ NO _ QWS _ DEPTH _8 

화소당 8 bit ： 40보조색을 가지는 
216색립방체. QWS _ DEPTH _8 G 
RAYSCALE 와 비호환. 


QT _ NO _ QWS _ DEPTH_l 

5 

화소당 15 bit ： 적，록，청의 매개에 
32준위. 


QT _ NO _ QWS _ DEPTH_l 

6 

화소당 16 bit ： 록에 64준위，적과 
청색에 32준위씩. 


QT _ NO _ QWS _ DEPTH _3 

2 

화소당 32 bit ： 적，록，청 각각에 
256준위, 


QT _ NO _ QWS _ MACH 64 

Mach 64 가속구동기 (시위뿐). 


QT _ NO _ QWS_VFB 

XII 에 서 가상틀완충기실 행 (참고 
문서를 보시오). 



망프로그람직^ 


QT _ NO_NETWORK 

PROTOCOL 

국부파일검색을 포함하는 추상다중 
통신규약자료검색 
(QNetwo rkP rotoco 1 ) 


QT _ NO_NETWORKPR 

O 

TOCOL_FTP 

FTP 통신규약자료검색. 

QT _ NO_NETWOR 

K 

PROTOCOL 

QT _ NO_NETWORKPR 

O 

TOCOL_HTTP 

HTTP 통신규약자료검색. 

QT _ NO_NETWOR 

K 

PROTOCOL 

그리기와 그림 

QT _ NO_COLORNAMES 

일부 QColor 구성자들과 일부 

HTML 문서 ( QColor , 

QStyleSheet ) 들에서 쓰이는 

” red " 와 갈은 색이 름들 


QT _ NO_TRANSFOR 

MATIONS 

Qt 에서 많은 콜라스들에서 사용 
한다. 이와 함께 회전과 비례화도 
가능하다. 이것이 없으면 좌표변환 
( QWMatrix ) 만 할수 있다. 


QT _ NO_PSPRINTER 

PostScript 인쇄기지원. 



인쇄기지원 ( QPrinter ) QT NO PSPRINT 


QT _ NO_PSPRINTER 
QT _ NO _ PRINTER 一一 






창문부품 


QT _ NO_WIDGETS 

이것을 허용하지 않으면 QWidget 
를 제외한 모든 창문부품들을 금지 
한다. 


QT _ NO_TEXTVIEW 

HTML 문서보기 ( QTextView ) 

QT _ NO_WIDGET 
S , QT _ NO_RICHT 
EXT 

QT _ NO_TEXTBROWSE 

R 

HTML 문서 열 람 ( QTextBrowser ) 

QT _ NO_TEXTVIE 

W 

QT _ NO_ICONVIEW 

표식화된 그림기호들 

( QlconView ) 

QT _ NO_WIDGET 
S , QT _ NO_DRAG 
ANDDROP 

QT _ NO_LISTVIEW 

정보목록 ( QListView ) 

QT _ NO_WIDGETS 

QT-NCLCANVAS 

객체캔버스 ( QCanvas ) 

QT _ NO_WIDGETS 

QT _ NO_DIAL 

값조종 ( QDial ) 

QT _ NO_WIDGETS 

QT _ NO_WORKSPACE 

MDI (다중문서대면부) 

( QWorkspace ) 

QT _ NO_WIDGETS 

QT _ NO_LCDNUMBER 

LCD 형식의 수값현시 

( QLCDNumber ) 

QT _ NO_WIDGETS 


GUI 형식 


QT _ NO _ STYLE _ 

WINDOWS 

Microsoft Windows 형 식 (QWind 
owsStyle ) 

QT _ NO_WIDGETS 

QT _ NO _ STYLE_MOTIF 

OSF Motif 형 식 ( QMotifStyle ) 

QT _ NO_WIDGETS 

QT _ NO _ STYLE_CDE 

Open Group CDE 형 식 (QCDESt 
yle ) 

QT _ NO _ STYLE_M 

OTIF 

QT _ NO _ STYLE_AQUA 

MacOS X 형 식 ( QAquaStyle ) 


QT _ NO _ STYLE _ 

PLATINUM 

MacOS 9 형 식 ( QPlatinumStyle ) 

QT _ NO_WIDGETS 

QT _ NO _ STYLE_SGI 

SGI 형 식 ( QSGIStyle ) 

QT _ NO _ STYLE_M 

OTIF 


可 W 


QT _ NO_DIALOGS 

이것을 허용하지 않으면 모든 공통 
대화칸 QWidget 들을 금지 한다. 

QT _ NO_WIDGETS 

QT _ NO_FILEDIALOG 

파일선택대화칸 ( QFileDialog ) 

QT _ NO_DIALOG 
S , QT _ NO_NETW 
ORK 

PROTOCOL , QT _ 
NO_LISTVIEW 

QT _ NO_FONTDIALOG 

서 체 선택 대화칸 ( QFontDialog ) 

QT _ NO_DIALOG 




마크로 

금지 

다음에 의하여 자동 
설정 



S , QT _ NO_FONT 
DATABASE 

QT _ NO_COLORDIALO 

G 

색 선택 대화 칸 ( QColorDialog ) 

QT _ NO_DIALOGS 

QT _ NO_INPUTDIALOG 

본문입력대화칸 ( QInputDialog ) 

QT _ NO_DIALOGS 

QT _ NO_MESSAGEBOX 

통보문/재촉문대 화칸 
( QMessageBox ) 

QT _ NO_DIALOGS 

QT _ NO_PROGRESS 

DIALOG 

긴계산진척상황대화칸 
( QProgressDialog ) 

QT _ NO_DIALOGS 

QT _ NO_TABDIALOG 

타브페지대화칸 ( QTabDialog ) 

QT _ NO_DIALOGS 

QT _ NO_WIZARD 

여러걸음대화칸 ( QWizard ) 

QT _ NO_DIALOGS 


제 3 절. Qt / Embedded 에 고유한 클라스들 

Qt/Embedded 들라스들은 두가지로 분류된다. 즉 기본은 매개 Qt/Embedded 프로 
그람에서 사용되며 일부는 Qt/Embedded 봉사기에 의해서만 사용된다. 또한 
Qt/Embedded 봉사기프로그람은 단일프로쎄스설치인 경우에 의뢰기 일수도 있다. 
Qt/Embedded 에 고유한 모든 원천파일들은 src/kernel 에 있으며 뒤붙이 qws 가 있다. 
-기호는 계승을 가리 킨다. 

接) QFontManager 

응용프로그람마다 다음것들중 하나가 있다. 응용프로그람이 기동할 때 
$ QTDIR / etc / fonts/fontdir (혹은 QTDIR 가 정의되지 않으면 / usr / local / etc / qt - 
embedded / fonts / fontdir ) 로부터 서체정의파일을 읽어들인다. 이것은 모든 서체정보를 
유지하며 표시된 서체들의 캐쉬를 관리한다. 또한 서체공장을 창조하며 
QFontManager: : QFontManager 는 새 공장용구성자를 추가하는 곳이 다. 이것은 특정 
한 서체를 요구하기 위한 고급한 대면부를 주며 QFon 切 'actories 를 호출하여 요구에 따 
라 디 스크로부터 서체들을 적재한다. 이것 은 오직 BDF 와 TrueType 서체 들에 만 적 용되 
며 Qt/Embedded 의 최적화된 .qpf 서체파일형식은 QFontManager 기구와 함께 넘긴다. 

서체대조 혹은 동작캐슁을 변경하지 않으려면 이 클라스를 수정하지 말아야 한다. 

② QDiskFont 

이것은 하나의 디스크서 체 파일정보를 포함한다. (실례로 /us r / local / etc / qt - 
embedded / times . ttf ). 이것은 파일경로，서체가 비례가능한가하는것과 그 무게，크기， 
Qt/Embedded 이름 등에 대한 정보를 보관한다. 이 정보를 리 용하여 QFontManager 
는 제일 근사한 디스크서체를 찾을수 있다. (이것은 일치하는 이름들에 대하여 무게를 
정한 득점기록기구를 사용하고 그다음에는 서체가 경사체인가，아닌가, 그다음 그 무게 
를 리용한다.) 

이 콜라스를 수정할 리유는 없다. 

③ QRenderedFont 
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체계에 의하여 현재 적재된 매개의 유일한 서체에 대하여 오직 하나의 
QRenderedFont 가 있다. (즉 매개가 이름，크기，무게，경사체의 유일한 결합). 
QRenderedFont 들은 참고계수되며 QRenderedFont 를 사용하는것이 없으면 글리프비 
트매프의 캐쉬와 함께 삭제된다. 적재된 QDiskFont 는 그 QFontFactory 에 의하여 열 
려져있 다 

글리프가 캐쉬되는 방법을 변경하지 않는다면 이 들라스를 수정할 까닭이 없다. 

④ QFontFactory 와 자손들인 QFontFactoryBDF , QFontFactoryTtf 

이것들은 특정한 서체형식 실례로 비례가능한 Tmetype 와 Typel 형식(둘다 

Freetype 2을 사용하는 QFontFactoryTtf 에서 유지) 그리고 표에서 사용하는 비트매 
프 BDF 형 식 에 대 한 지 원을 제 공한다. 이것은 디스크서 체를 열기 위하여 호출된다. 서 체 
가 열리면 디스크로부터 새 서체의 창조를 고속화하기 위하여 열 려진채로 있다. 또한 
QRenderedFont 를 창조하고 유니코드값들로부터 서체파일에로의 첨수로 변환할수 있 
다. 단순성 을 위하여 글리 프는 유니 코드순서 가 아니 라 서체 에 정의 되 는 순서와 첨수로 
보관된다. 

이 콜라스를 수정할 필요가 없지 만 각이한 형 태의 서 체 묘사기 를 추가하려 고 한다면 
(실례로 사용자정의 벡토르 서체형식에 대하여) 계승되여야 한다. 

⑤ QGlyph 

이것은 QRenderedFont 로부터 문자의 특별한 화상을 서술한다. 실례로 Times 
New Roman , 강조경사체，반별명식의 lOpoint 의 문자 ’ A ’. 이것은 그 문자에 대한 
정보를 가진 QGlyphMetrics 구조체의 지적 자와 그 글리프에 대한 생 자료의 지적 자를 
포함한다. 이것은 lbit 마스크이거나 8 bit 알파통로이다. 매개의 QRenderedFont 는 요 
구에 따라 이것들을 창조하고 보관한다. (이것은 현재 TrueType 서체들에 실현되지 않 
는다. ) 

가령 본문서체를 유지하기 위하여 Qt/Embedded 를 수정하고있다면 이 콜라스를 
수정 할 필요가 있는데 이 경우에 QGfxRaster 도 수정 하여 야 한다. 

⑥ QMemoryManagerPixmap/QMemoryManager 

이 처 리 함수들은 픽 스매 프들을 위한 공간을 요구하며 또한 QPF 형 식서 체들의 궤 적 
을 보유한다. (이것들은 크기가 2-20 KB 정도인 QRenderedFonts 의 자그마한 상태출력 
이며 기억기에 보관하기 위하여 디스크로부터 직접 mmap 될수 있다.) 새로운 
QRenderedFont 를 창조할 필요는 없고 서체요구와 일치 하는 QPF 서체 가 발견된다. 자 
기의 서체요구가 적당하면(실례로 고정점크기를 적게 요구한다면) 모든 QFontFactory 
기능을 버리고 간단히 QPF 들을 사용할수 있다. 제 일 잘 일치하는 적재 가 QPF 들에서 
수행되지 않으면 QFontManager 를 거처서 적재되는것들과 반대이므로 점크기와 꼭 같 
은 QPF 가 없으면 그 크기의 본문이 간단히 표시되지 않는다. 

이 콜라스를 수정 할 필요는 없 다. 

⑦ QScreen — QLinuxFbScreen — 가속화된 화면들， QTransformedScreen 나 
QVfbScreen 

이것들은 Qt/Embedded 가 그리 고있는 틀완충기를 名폐 하며 틀완충기를 회 전하기 
위 한 자리 표변환을 유지 하며 조색 판의 실현을 가능하게 하고 개 별적 인 틀완충기억 기들을 
가지는 장치들에 대하여 비화면그라픽스에로의 호출을 제공한다. 

이것은 픽 스매프 캐슁과 가속화된 픽 스매프 =〉화면 bit 를 가능하게 하는데 쓰인다. 
QLinuxFbScreen 과 가속화된 화면은 Linux / dev/fb 대면부를 사용하여 그라픽스기억 
기에 대한 호출과 장치의 특성에 대한 정보를 엄는다. 열려는 틀완충기는 
QWS_DISPLAY 에 의하여 지정된다. 유일한 QTransformedScreen 은 회전식 틀완충 
기에 과한 지원을 실현한다. QVfbScreen 는 모의식 틀완충기를 포함하는 X 창문을 제공 
한다. (공유기억기덩어리는 틀완충기결에 설정되여 X 창문에 bit 된다.) 이것은 표를 완료 
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함이 없이 Qt/Embedded 하에서 사용자들이 자기의 응용프로그람들을 수정 하게 하는 오 
유수정장치로서 사용하는 경향이 있다. 가속된 화면구동기들은 그것들이 
QWS _ CARD_SLOT 에 의하여 지정된 장치 (지정되지 않으면 기정으로 AGP 처리부의 
일 반위 치 로 되 여있 다)를 구동할수 있는가 검 사하고 / dev/mem 으로부터 소편상등록기 들 
을 사영한다. 또한 그것들은 알려진 값들로 등록기들을 초기화하여 소편에 고유한 설정 
을 진행할수 있다. 끝으로 QScreen 은 새로운 QScreenCursor 와 QGfx 들을 창조하는 
데 리용된다. 

픽스매프들이 기억기에 할당되는 방법을 수정하려고 한다면 QLinuxFbScreen 의 
파생 들라스를 만들거 나 수정 한다. 가속화된 장치 구동프로그람을 쓰고있 다면 QScreen 
혹은 QLinuxFbScreen 의 파생콜라스를 만들 필요가 있다. 

⑧ QScreenCursor — 가속화된 유표— QVfbCursor 

이것은 화면상의 마우스유표그리기와 비가속화된 유표형에 대하여 화면의 보존과 
되살리기를 조종한다. 

QScreenCursor 의 파생들라스작성은 가속화된 구동기에 최적이다. (하드웨어가 
하드웨 어유표를 유지하면 그렇게만 하려고 할수 있다.) 

⑨ QGfx — RasterBase — Raster — 가속화된 구동기 — QGfcVfb 서 3 GfxTransformedRaster 

이 들라스는 저수준 QPainter 와 같은 그리기조작을 은폐한다. QGfxRaster 와 그 
자손들은 미숙한 틀완충기에로 그리기 위하여 특별히 작성되였다. 이것들은 그리기조작 
을 위 한 변위와 창문에 대 한 그리기를 지 원하기 위 한 절단령 역을 가질수 있다. 가속화된 
구동기를 실현하기 위하여 QGfxRaster 형판의 파생콜라스를 만들어야 한다. 

QGfxRaster 를 수정하여 그리기방법을 전용화하거나 새로운 비트깊이와 화소형식 
의 지원을 추가할수 있다. 

⑩ QLock , QLockHolder 

이것은 Qt/Embedded 의뢰기들사이에 공유된 기억기에 대한 동기호출에 쓰이는 
System V 신호기 발 ( semaphore ) 을 은페 한다. QLockHolder 는 QLock 를 더 간단히 
관리하고 해체하게 하는 편의콜라스이다. 

System V IPC 없는 조작체계 에 Qt/Embedded 를 이식 하지 않는다면 이 콜라스를 
수정 할 필요가 없다. 

⑪ QDirectPainter 

이것은 가리키고있는 창문의 지적자와 창문의 절단령역 등을 주는 QPainter 이다. 
이것은 창문내용의 화소준위조작을 간단히 수행하기 위한것이다. 

이 콜라스를 수정할 리유는 없다. 

⑫ QWSSoundServer , Client 

Qt/Embedded 봉사기는 간단한 음성재생기와 혼합기를 포함한다. 의뢰기들은 파일 
로서 지정된 봉사기재생음성을 요구할수 있다. 

Linux 형식의 / dev/dsp 없는 조작체계에 Qt/Embedded 를 이식하지 않는다면 이 
콜라스를 수정할 필요가 없어 야 한다. 

⑬ QWSWindow 

이것은 개별적인 제일 웃준위창문의 봉사기능력을 포함한다. 그것이 할당되는 틀완 
충기의 령역，그것을 창조한 의뢰기 등. 

이 콜라스를 수정할 리유는 없다. 

⑭ QWSKeyboardHandler 수보조형 

이것은 건반/단추입력을 조종한다. QWSKeyboardHandler 는 파생콜라스로서 
/ dev/tty 와 독단적 인 저 준위 USB 사건장치 (USB 건반에 대 하여 )， 일부 PDA 단추장치 들 
을 읽기 위하여 제공된다. 

QWSKeyboardHandler 의 수정은 각이한 형식의 건반을 유지하게 하며 (현재 상 
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당히 표준인 US PC 형식건반만 유지된다.) 그 파생콜라스를 만드는것은 비지적자입력 
장치들을 조종하는 좋은 방법 이 다. 

⑮ QWSMouseHandler — QWSCal 化 ratedMouseHandler — 마우스형 

이것은 마우스/손접촉화면입력을 조종한다. QWSCal 比) ratedMouseHandler 의 자 
손들은 려과코드를 사용하여 손접촉화면에서 지적자의 순간요동 ( jittering ) 을 방지한다. 
일부 매몰형 장치는 핵심에서 이 려과를 수행하며 그 경우에 구동기는 
QWSCal 比) ratedMouseHandler 로부터 계승할 필요가 없다. 

QWSCal 比 ratedMouseHandler 의 파생들라스작성은 핵심려과없는 손접촉화면에 
선택 되 며 QWSMouseHandler 의 계 승은 다른 형 의 지 정 장치(펜 타블레 트，손접 촉화면， 
마우스，추적구 등)를 추가하는 방법 이 다. 

⑯ QWSDisplay 

이 콜라스는 Qt / Embedded 봉사기에서만 존재하며 체계에서 건반과 마우스는 물론 
모든 제일웃준위창문들의 궤적을 보유한다. 

Qt / Embedded 창문(실례로 알파상표가 있는 창문들)동작에 대한 심중한 수정을 하 
려면 이것만 수정하면 된다. 

⑫ QWSServer 

이것은 의뢰기에 대한 Qt / Embedded 봉사기의 Unix 령역소케트련결을 관리한다. 
이것은 QWS 통신규약사건들을 송수신하며 QWSDisplay 를 호출하여 창문의 할당령역 을 
변경하는 일을 수행한다. 

이것을 수정하려는 유일한 리유는 소케트부류의 기구가 아닌 다른것을 리용하여 
Qt / Embedded 응용프로그람들사이에 교제 하려는것이다. (그러 한 경우에 QWSClient 도 
수정 한다.) Unix 령 역 소케 트와 같은것 을 가지 고있으면 그대 신에 QWSSocket / 
QWSServerSocket 를 수정한다. 응용프로그람들사이에 교제하기 위하여 여분의 QWS 
사건들을 추가하지 말고 대신에 QCOP 를 사용한다. 

⑯ QWSClient 

이것은 Qt / Embedded 련결의 의뢰기측면을 은폐 하며 사건들을 정 렬하고 해체 할수 
있 다. Qt / Embedded 응용프로그람들사이 에 교제 하기 위 하여 Unix 령 역 소케 트와 근본적 
으로 다른것을 사용하는 경우를 제외하고 이것을 수정할 리유는 없다. 

⑬ QWSDisplayData 

이것은 QWS 봉사기 로부터 오는 사건들을 읽어들이고 해석하는 의 뢰 기의 
QWSClient 를 관리한다. 이것은 응용프로그람기동시 에 QWS 봉사기와 련결하여 틀완충 
기 에 대 한 정 보를 엄 고 기 억 관리기 를 창조한다. 틀완충기 에 대 한 다른 정 보는 
QLinuxFbScreen 의 / dev / fb 로부터 직접 온다. 

이것을 수정할 리유는 없다. 

⑩ QWSCommand 들 

이것들은 QWS 봉사기 에 대 하여 송신하는 자료를 은페 한다. 

이 것 들을 수정할 리 유는 없 다. 

@ QCopChannel 

QCop 는 Qt / Embedded 응용프로그람들사이에 교제를 위한 간단한 IPC 기구이다. 
선택적 인 2진자료를 가지는 문자렬통보는 각이한 통로들에 전송될수 있다. 

그 기구자체는 사용자가 제일 우에 있는 기구를 구축하는것이 기본으로 되도록 설 
계된 다. 

© QWSManager 

이것은 제목띠의 그리기와 창문크기조절에 대한 사용자요구의 처리 등 

Qt / Embedded 창문관리를 제공한다. 

이것을 수정할 리유는 없지만 창문동작을 수정하려면 그 파생콜라스를 만들어야 한다. 
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© QWSDecora 吐 on 

이 클라스의 자손들은 Qt/Embedded 창문관리기에 대하여 형식이 각이하다. 실례 
로 QWSWindowsDecoration 은 Windows CE 의 형식으로 Qt/Embedded 창문틀을 
그린다. 

그로부터 클라스를 파생 시 켜 Windows XP 혹은 Enlightenment 주제와 등가한 새 
토운 창문관리기의 외관을 제공한다. 

® QWS Property Manager 

이 것은 QWS 의뢰기의 대 면부를 QWS 속성체 계(류사한 판의 X 속성체 계 . 이것은 제 
일 웃준위창문들에 옹근수로 식별된 독단적인 자료를 붙이게 한다.)에 제공한다. 

이것을 수정할 리 유는 없다. 

逐) QWSRegionManager 

의뢰기와 봉사기에서 제일 웃준위창문령역의 관리를 방조한다. 

이것을 수정할 리유는 없다. 

@ QWSSocket , QWSServerSocket 

Unix 령 역소케트를 제공한다. 

비 Unix OS 에 이 식 하고있는데 Unix 령 역소케트(바이트지 향의 믿음성있고 순서화된 
전송기구. 물론 통보대기렬과 갈은것을 가지고도 실현할수 있다.)와 류사한것을 가지려 
면 이것을 수정한다. 


제4절. Qt / Embedded 에 가속기그라픽스구동프로그람추가 

Qt/Embedded 는 하드웨어가속기를 사용할수 있는 능력을 가지고있다. PCI 혹은 
AGP 구동기용 하드웨 어가속기를 사용하려면 다음의 단계들을 수행해 야 한다. 

® QLinuxFbScreen 의 가속기자손을 정의 한다. 

이것은 등록기들을 변환하기 위 하여 QVoodooScreen : : connect 0를 실현한다. 
qt _ probe_bus 를 사용하여 PCI 환경공간의 지적자를 얻는다. 이것은 PCI 장치/제작회사 
ID 정보를 사용하여 정확한 장치를 가리키고있는가를 검사하는 곳이다. 그다음 PCI 환경 
공간을 리 용하여 자기 장치 의 가속기 등록기 들을 물리 기억 기 에 배 치 하고 / dev/mem 으로 
부터 적당한 령역을 사영한다. 프레임완충기를 사영할 필요는 없으며 
QLinuxFbScreen 가 이것을 수행한다. 문제가 생기면 FALSE 를 돌려준다. 
QVoodooScreen :: initDevice () 는 QWS 봉사기에 의해서만 호출되며 그리기가 수행되 
기전에 호출되도록 담보된다. (그리하여 알려진 상태들로 등록기들을 설정할수 있는 위 
치 이다.) connectO 는 매 개의 련결되는 의뢰기 에 의 하여 호출된다. 

資) QGfxRaster 의 가속기 자손을 정의 한다. 

이것은 실제의 그리기코드가 이행하는 곳이다. 하드웨어에서 실현되지 않은것은 
QGfxRaster 에 로 넘기여 쏘프트웨 어 에서 수행 할수 있다. optype 변수를 리용하여 가속 
조작과 비가속조작들이 동기화된다는것을 확인한다 . ( 하드웨어가속기가 아직 그리고있는 
령역에로 쏘프트웨어를 거처서 그리기를 시작하면 그리기조작은 잘못된 순서로 나타난 
다.) optype 는 공유기억기에 보관되고 비가속조작에 의하여 0으로 설정되며 가속조작 
은 1로 설정된다. 쏘프트웨어그라픽스조작이 요구되고 optype 가 1일 때 
QGfxRaster : : sync 0가 호출되 고 그라픽스엔진에 일감이 없기를 기 다리는 자체의 실현 
을 제공해 야 한다. 역시 lastop 는 최적화에 사용되 고 공유기억기 에 보관되며 이것은 쏘 
프트웨어 전용 QGfx 에 의하여 설정 되 지 않으며 자기 의 마지 막 조작의 형 (실례 로 직 4각형 
그리 기 )을 보관하여 같은 조작이 순차로 많이 수행 될 때 다음 조작을 위한 설정부분을 
피하는데 리용할수 있다. 
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모든 그리기조작은 임의의 등록기， lastop 혹은 optype 가 호출되기 전에 
QWSDisplay : : grab () 를 통하여 보호되 여 야 하며 마감에 ungrabbedO 해 야 한다. 이 
것은 동시 에 두개의 응용프로그람들이 가속기를 호출하는것을 방지 하며 될수록 름퓨터를 
잠그어둔다. 이것은 자기의 원천코드가 그라픽스카드에 놓이지 않을수 있게 하므로 그러 
한 경우를 검사하고 필요하다면 쏘프트웨어로 되돌아와야 한다. QGfxRaster 는 
QPainter 가 직접 유지 하지 않는 기능을 유지 한다. (실례 로 32 bit 의 알파통로와 
stretchBlt ). 이 기 능들은 Qt 에 의 해 사용되 며 stretchBlt 는 QPixmap : : xForm () 와 
drawPixmap 0를 변환된 QPainter 로 가속화하며 알파통로가속은 32 bit 픽스매프를 위 
하여 유지된다. 

:遠)필요하다면 QScreenCursor 의 가속기자손들을 정의한다. restoreUnderO 와 
saveUnderO , drawCursor ()， draw () 는 null 조작으로 정의되여야 한다. set () 와 
moveO , showO , hideO 를 실현한다. 4 KB 는 틀완충기의 보임부분의 끝에 자기 유표 
용으로 남겨둔다. (즉 ( width * height * dep 比 i )/8 에) 

④ 자기의 QScreen 자손에 initCursorO 와 createGfxO 를 실현한다. 
useOffscreenO 를 실현하고 비화면 ( offscreen ) 그라픽스기억 기를 사용할수 있으면 
TRUE 를 돌려준다. 

⑤ 단지 새 로운 QMychipScreen 를 돌려 주는 작은 함수 qt _ get _ screen _ mychip () 
를 실현한다. 

■道) qgfxraster _ qws . cpp 안의 DriverTable 표에 자기 구동기를 추가한다. 실례로 

{ " MyChip ", qt _ get _ screen _ mychip , 1 }, 

첫 파라메터 는 자기 의 가속구동기 를 요구하기 위하여 QWS _ DISPLAY 와 함께 사 
용되는 이름이다. 

⑦ 새 구동기 로 실 행하려 면 

export QWS _ DISPLAY=MyChip 

(선택적으로 / dev/fbO 보다도 각이한 Linux 프레임완충기를 요구하려면 

MyChip :/ dev / fb < n >), 그다음 프로그람을 실행한다 

자기 구동기가 PCI 나 AGP 가 아니면 QLinuxFbScreen 대신에 QScreen 을 계승 
해야 하며 QLinuxFbScreen 에 류사한 기능을 실현해야 하지만 그렇지 않으면 처리는 
비슷해야 한다. 대부분 완성된 실례구동프로그람은 qgfxmach 64— qws.cpp 이고 
qgfxvoodoo _ qws . cpp 는 더 작고 리 해하기 쉬운 구동프로그람을 제공할수 있다. 


제5절. Linux 틀완충기의 허용 

이것은 간단한 차림표이다. 

① / usr / src / linux / 에 Linux 핵심원천코드가 있는가 확인한다. 

② 루트로서 가입하고 cd / usr / src / linux 를 실행한다. 

③ 핵심의 환경을 구성한다. 

실행 : 

make menuconfig 

"Code maturity level options " 를 선택하고 "Prompt for development 
and/or incomplete code / drivers ” 를 설정 한다. 

그다음 "Console drivers ” 를 선택하고 "Support for frame buffer devices " 를 
설정 하여 구축한다. 그다음 구동프로그람의 환경을 구성 한다. 대부분의 현대그라픽스카 
드는 ” VESA VGA graphics console ” 을 리용할수 있으며 그것을 사용하거 나 자기의 
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비데오카드와 특별히 일치하는 구동프로그람을 사용한다. 끝으로 "Advanced low 
level driver options ’’ 를 허용하고 16 과 32 bpp 압축화소유지가 허용된다는것을 확인 
한다. 

완료하려면 exit 를 선택하고 보관한다. 

④ 핵심을 를파일한다. 

우선 

make dep 
다음 

make bzlmage 

새 핵심은 현재 arch / i 386/ boot / bzImage 에 있어야 한다. 

⑤ 핵심을 boot 등록부에 복사한다. 

cp arch / i 386 / boot / bz I mage / boot / linux . vesafb 

⑥ / etc / lilo . conf 를 편집한다. 

주의: / etc / lilo . conf 의 일시사본을 보관하고 구원디스크를 사용할수 있게 한다. 
오유를 범하면 를퓨터 가 기동할수 없다. 

파일 / etc / lilo . conf 는 체계기동방법을 지정한다. 파일의 정확한 내용은 체계마다 
다르다. 여기에 실례가 있다. 

# LILO configuration file 
boot = / dev / hda 3 
delay = 30 

image = / boot/vmlinuz 
root = / dev / hda 3 
label = Linux 

readt^nly # Non-UMSDOS filesystems should be mounted readonly for checking 
other =/ dev/hdal 
label=nt 
table =/ dev/hda 

처음것의 사본인 새 ’’ image ” 절을 만든다. 

image = / boot / linux . vesafb 
그리고 

label = Linux-vesafb 
그것을 바로 첫 화상부분우에 배치한다. 

vga = 791을 말하는(1024 X 768，16 bpp 를 의미하는) 화상부분앞에 한 행을 추가 
한다. 

우의 실례에서 lilo . conf 는 현재 다음과 같다. 

# LILO configuration file 
boot = / dev / hda 3 
delay = 30 

vga = 791 

image = / boot / linux . vesafb 
root = / dev / hda 3 
label = Linux-vesafb 

read-only # Non-UMSDOS filesystems should be mounted read-only 
for checking 

image = / boot/vmlinuz 
root = / dev / hda 3 
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label = Linux 

read-only # Non-UMSDOS filesystems should be mounted read-only 
for checking 

other=/dev/hdal 

label=nt 

table=/dev/hda 

파일의 현존행들을 변경하지 말고 새 행들을 추가한다. 

⑦ 새 변경을 적용하고 lilo 프로그람을 실행한다. 
lilo 

⑧ 체계를 재기동한다. 이제는 체계(혹은 다중처 리소자를퓨터에서 하나이상)가 기 
동할 때 펭긴새로고를 볼수 있다. 

⑨ 새 핵심에서 적당히 기동하지 않으면 LILO 재촉문에서 낡은 화상부분의 표식을 
입력하여 낡은 핵심으로 기동할수 있다. (실례에서 lilo.conf 파일, 낡은 표식은 Linux 
이다.) 

아마 lilo.conf 에서 오유로 인하여 이것이 작업하지 않으면 구원디스크로 콤퓨터를 
기동하고 일시사본으로부터 /etc/lilo.conf 를 되살리고 lilo 를 재실행 한다. 

⑩ 시험: 여기에 틀완충기를 열고 사선으로 채운 적색 바른4각형을 그리는 간단한 
프로그람이 있다. 

#include <unistd.h> 

#include <stdio.h> 

#include <fcntl.h> 

#include <linux/fb.h> 

#include <sys/mman.h> 

int mainO 

{ 

int fbfd = 0； 

struct fb_var_screeninfo vinfo； 
struct fb_fix_screeninfo finfo； 
long int screensize = 0； 
char *fbp = 0； 
int x = 0, y = 0； 
long int location = 0； 

// Open the file for reading and writing 
fbfd = open( M /dev/fbO M , O.RDWR) ； 
if Ofbfd) { 

printf (’’Error: cannot open framebuffer device. \n M ) ； 
exit ⑴ ； 

} 

printf ("The framebuffer device was opened successfully. \n M ) ； 


// Get fixed screen information 
if (ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo)) { 
printf ("Error reading fixed information. \n M ) ； 
exit (2) ； 
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// Get variable screen information 
if (ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo)) { 
printf ( ” Error reading variable information An n ) ； 
exit (3) ； 

} 

printf ("%dx%d, %dbpp\n", vinfo.xres, vinfo.yres, 

vinfo. bits_per_pixel ) ； 

// Figure out the size of the screen in bytes 

screensize = vinfo.xres * vinfo.yres * vinfo.bits 一 per 一 pixel / 8 ； 

// Map the device to memory 

fbp = (char *)mmap(0, screensize, PROT_READ | PROT_WRITE, 
MAP_SHARED, fbfd, 0); 
if ((int)fbp == -1) { 

printf (’’Error: failed to map framebuffer device to memory An") ； 
exit (4 )； 

} 

printf ("The framebuffer device was mapped to memory 

successfully. \n”) ； 

x = 100 ； y = 100 ； // Where we are going to put the pixel 

// Figure out where in memory to put the pixel 
for ( y = 100 ； y < 300 ； y++ ) 
for ( x = 100 ； x < 300 ； x++ ) { 

location = (x+vinfo. xoffset) * (vinfo. bits_per_pixel/8) + 

(y+vinfo. y off set) * finfo. line_length ； 

if ( vinfo. bits_per_pixel == 32 ) { 

*(fbp + location) = 100 ； // Some blue 

*(fbp + location + 1) = 15+(x-100)/2 ； // A little green 

*(fbp + location + 2) = 200-(y-100)/5 ； // A lot of red 
*(fbp + location + 3) = 0 ； //No transparency 

} else { //assume 16bpp 
int b = 10 ； 

int g = (x-100)/6; //A little green 

int r = 31-(y-100)/16; // A lot of red 
unsigned short int t = r«ll | g « 5 | b ； 

*((unsigned short int*) (fbp + location)) = t ； 

} 

} 
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munmap(fbp, screensize) ； 
close (fbfd) ； 
return 0 ； 


제 6 절 . Qt/Embedded 응용프로그람의 실행 

Qt/Embedded 응용프로그람은 주응용프로그람에서 실행되거나 그 자체가 주응용프 
로그람이 여야 한다 . 주응용프로그람은 우선 제 일웃준위 창문령 역 과 지 적 자，건반입 력 의 
관리를 책 임져 야 한다 . 

Qt/Embedded 응용프로그람은 QApplication 객 체 를 QApplication: :GuiServer 형 
으로 구성하거 나 -qws 지 령행 추가선택 으로 실 행 함으로써 주응용프로그람으로 될수 있 다 . 

이 절은 정확히 환경구성된 Linux 틀완충기를 가지고있고 어떤 주프로쎄스도 실행 
하지 않고있는것을 가정한다 . 작업중에 있는 Linux 틀완충기가 없으면 Qt/Embedded 
가상틀완충기 를 사용하거 나 VNC 봉사기 로서 Qt/Embedded 를 실 행할수 있 다 . 

Linux 콘솔로 변경하고 실행하려는 실례를 선택한다 . 실례로 examples/widgets. 
$QTDIR 가 Qt/Embedded 를 설치한 등록부로 설정된것을 확인하고 $QTDIR/lib 등록 
부를 $LD_LIBRARY_PATH 에 추가한다 . 실례로 
export QTDIR=$HOME/qt-VERSION 

export LD_LIBRARY_PATH=$QTDIR/lib : $LD_LIBRARY_PATH 
-qws 선택 을 지 정하여 응용프로그람을 실 행한다 . 
cd $QTDIR/examples/widgets 
. /widgets -qws 

widgets 실례가 나타나는가를 알아야 한다 . 마우스가 정확히 작업하지 않으면 사용 
하려는 마우스의 형을 지정해야 한다 . 임의의 시각에 Ctrl+Alt+Backspace 을 리용하여 
마스터 응용프로그람을 완료할수 있 다 . 

추가적인 응용프로그람들을 실행하려면 그것들을 의뢰기로서 즉 -qws 선택이 없이 
실행해야 한다 . 

1. 현시기 

Qt/Embedded 는 여러개의 Qt/Embedded 주프로쎄스들을 실행하여 여러개의 현시 
기들을 동시 에 사용하게 한다 . 이것은 - display 지 령행 파라메 터 혹은 
$QWS_DISPLAY 환경변수를 사용하여 달성된다 . 

-display 파라메 터 의 문법 은 다음과 같다 . 

[gfx drivepj ： driver specific options] [: display number] 

실례로 fbl 에서 mach64 구동기를 display 2 로서 사용하려면 
$ . /launcher -display Mach64 : / dev/fbl : 2 
이 기능을 실행하려면 다음과 같이 할수 있다 . 

0 VC 1 ( 가상콘솔 1) 로 변경 하고 발사기 (launcher ) 를 실행 한다 . 

$ cd examples/launcher 
$ . /launcher 

疫 ) VC 2 로 절 환하고 다른것 을 실 행한다 . 

$ cd examples/launcher 
$ . /launcher -display ：1 

다른 발사기가 기동된다 . 이 발사기에서 응용프로그람을 기동한다 . 

■③ Ctrl+Alt+Fl 를 눌러서 display 0 으로 돌아온다 . 또한 현시기 id 를 지정하여 특 
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정한 현시 기 에서 추가적 인 응용프로그람들을 기동할수 있다 . VC 3 으로 변경한다 . 

$ cd examples/widgets 
$ . / widgets -display ：1 

그러면 dislpay ：1 (VC 2 ) 에 창문부품실례를 현시한다 . 

주프로쎄스만이 driver 八 ievice 부분을 명시적으로 지정할 필요가 있다 . 의뢰기들은 련 
결될 때 주름퓨터로부터 필요한 정보를 엄는다 . 따라서 특별한 구동기를 리용하여 실행하 
고있는 주봉사기가 있으면 "client -display : n " 에 의하여 display n 을 사용할수 있다 . 

2. 마우스입력 

Qt/Embedded 는 기 정 으로 마우스를 자동탐지 하려 고 한다 . 유지 되 여있는 규약은 
MouseMan 과 Microsoft, IntelliMouse, 기 타 일정 한 하드웨 어 에 고유한 장치 (실례로 
Vr 손접 촉조종판 ) 들이다 . 사용하려 는 마우스를 지 정하려 면 $QWS_MOUSE_PROT ◦환 
경 변수를 설정한다 . 실례 로 

export QWS_MOUSE_PROTO=IntelliMouse 

마우스자동탐지는 직렬장치들과 그 장치들을 사용하는 다른 프로그람들과 충돌을 
일으키는 psaux 를 연다 . 그다음 마우스구동기규약과 장치를 명시적으로 지정한다 . 

제 7 절 . Qt/Embedded 에서 문자입력 

의 뢰기-봉사기통신규약에서 는 내부적 으로 건누르기 와 건놓기는 QWSKeyEvent 로 
서 송신된다 . QWSKeyEvent 는 표 9_2 와 같은 마당들을 포함한다 . 


표 9-2. 

QWSKeyEvent 의 마당 

Unicode 

유니 코드값 

keycode 

qnamespace.h 에서 정의된 Qt 건코드값 

modifier 

Qt ： ： ShiftButton, Qt ： : ControlButton, Qt: :AltBu 竹 on 의 일부 
로 구성되는 비트마당 . 

is_press 

건누르기이면 TRUE, 건놓기이면 FALSE. 

is_auto_repeat 

이 사건 이 자동반복에 의 해 발생하면 TRUE. 


봉사기가 건사건을 수신하면 그것을 매개 의뢰기프로쎄스에 송신하고 건사건을 처 
리하며 정 확한 창문에 전송하여 응답한다 . 건사건은 여 러 개의 다른 원천들로부터 온다 . 


1. 건반구동프로그람 

건반구동프로그람은 장치 로부터 자료를 읽어서 건사건을 봉사기 에 준다 . 

건반구동프로그람은 서 고로 콤파일되 거 나 플라그인으로서 적재될수 있 
다 . ./configure -help 를 실행하여 유효한 건반구동프로그람 들을 렬거 한다 . 竹 y 구동 
프로그람은 기정환경 에서 허용된다 . 

건반구동프로그람들은 모두 같은 패런을 따른다 . 그것들은 장치로부터 건반자료를 
읽어들이고 어느건을 눌렀는가를 알아내고 건반정보를 가지고 정적함수 
QWSServer ： : processKeyEventO 를 호출한다 . 

지금 콘솔건반구동프로그람은 또한 콘솔절환 (Ctrl+Alt-Fl...Ctrl+Alt+F10 ) 과 말 
단 (Ctrl+Alt+Backspace ) 을 조종한다 . 

새 장치에 대한 건반구동프로그람을 추가하려면 QWSKeyboardHandler 와 
QKbdDriverPlugin 의 파생콜라스들을 쓰고 플라그인으로 설치할수 있다 . 

2. 건사건려과기 (입 력메 쏘드) 

봉사기가 건반구동프로그람으로부터 건사건을 수신할 때 그것은 우선 려과기를 통 
과한다 . 
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이것은 건반에 없는 문자들의 입력을 제공하는 입력방식을 실현하는데 리용될수 있다 . 

입 력 방식 을 만들려 면 QWSServer :: KeyboardFilter 

(src/kemel/qwindowsystem_qws. h 에서)의 파생를라스를 만들고 가상함수 filter() 
를 실현한다 . filterO 가 FALSE 를 돌려 주면 사건은 QWSServer： : sendKeyEventO 
에 의하여 의뢰 기들에 전송된다 . filterO 가 TRUE 를 돌려주면 사건은 정지된다 . 새 건 
사건을 생성 하려 면 QWSServer: : sendKeyEventO 을 사용한다 . processKeyEvent() 
를 리용하지 않으므로 무한재귀를 일으킨다 . 

건반사건려과기를 설치하려면 QWSServer: :setKeyboardFilter () 를 사용한다 . 현 
재 유일한 려과기는 한번에 설치될수 있다 . 

려과는 봉사기프로쎄스에서 수행되 여 야 한다 . 

launcher 실 례 는 단순한 입 력방식 의 실 례 로서 SimplelM 은 파일 로부터 환치 표를 
읽 어들인다 . 

3. 펜입력 

건사건은 건반장치로부터 올 필요가 없다 . 봉사기프로쎄스는 임의의 시각에 
QWSServer: : sendKeyEventO 를 호출할수 있다 . 

일반적으로 이것은 창문부품을 꺼내여 사용자가 점지정장치로 문자들을 지정하게 
함으로써 수행된다 . 

알아두기 : 건입력창문부품은 초점을 가지지 말아야 하므로 봉사기는 그때 입력창문 
부품에로 건사건을 송신하군 한다 . 입력창문부품이 절대로 초점을 가지지 않는다는것을 
확인하는 한가지 방법은 QWidget 구성 자에서 WStyle_Customize 와 WStyle_Tool 창문부품기 
발들을 설정하는것 이 다 . 

Qtopia 환경 은 Handwriting Recognition 과 Virtual Keyboard 와 같은 여 러 가지 
입 력 창문부품들을 포함한다 . 


제 8 절 . Qt/Embedded 의 서체 


1. 유지하는 형식들 

Qt/Embedded 는 4 가지 서체형식을 유지한다 . 

표 9-3. _ Qt/Embedded 의 서체형식 


TrueType (TTF) 

비례가능서체기술은 현재 MS-Windows 와 Apple 
Macintosh 의 표준이며 XII 에서 류포되고있다 . 

Postscript Typel 
(PFA/PFB) 

인쇄기들에서 흔히 사용하는 비례가능서체，또한 XII 
에서도 류포되고있다 . 이것들은 TTF 서체와 기능이 
비 슷하다 . 

Bitmap Distribution 
Format 서 체 (BDF) 

비 례불가능서 체 의 표준형 식 . 많은 량의 BDF 서 체 들이 
표준 XII 배포물의 일부로서 제공되며 그 대부분은 
Qt/Embedded 에서 사용할수 있 다 . 생산체계 에서는 
이 서체들을 사용하지 말아야 한다 . 이 서체들의 적재 
는 아주 느리고 많은 기억공간을 차지한다 . 그대신 
BDF 를 QPF 로 묘사한다 . 

Qt P re rendered Font 
(QPF) 

Qt/Embedded 에 고유한 가벼운 비례불가능서체형식 . 


이 서체형식들(늘 허용되는 QPF 를 내놓고)의 매개의 유지는 Qt/Embedded 특성정 
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의를 사용함으로써 자유로 허 용 혹은 금지할수 있다 . 임 의의 서 체 로부터 QPF 서 체파일 
을 쓰기 위 한 지 원이 Qt/Embedded 에 있으므로 처 음에 TTF 와 BDF 형 식들을 허 용하고 
필요한 서 체와 크기들의 QPF 파일들을 보관하고 TTF 와 BDF 유지 에서 삭제한다 . 

TTF 와 BDF 로부터 QPF 파일들을 생성하는것 을 방조하는 도구에 대 해서는 
tools/makeqpf 를 참고하거 나 -savefonts 선택 을 지정 하여 자기의 응용프로그람을 실행 하 
시오 . 

2. 기억기요구 

TTF 서체에서 주어진 점크기의 서체에서 매개 문자는 그리기나 측도설정조작에서 
처음에 사용될 때만 묘사된다 . BDF 서체들에서 모든 문자는 서체가 사용될 때 묘사된다 . 
QPF 서체에서 문자들은 이가 그리기에 사용하는것과 같은 형식으로 보관된다 . 

실례로 아스키문자들을 포함하는 lOpoint Times 서체는 QPF 형식으로 보관될 때 
약 1300byte 를 사용한다 . 

QPF 형식이 구조화되는 방식의 우점을 리용하여 Qt/Embedded 자료를 읽어서 문법 
해석하는것보다도 기 억기사영 한다 . 이것은 앞으로 RAM 소비를 줄인다 . 

비례 가능서체들은 서체당 더 많은 량의 기 억기를 사용하지만 그 매 개 서체 가 서 로 
다른 많은 크기를 요구한다면 기억기를 절약하게 한다 . 

3. 원활한 서체 

TTF 와 PFA, QPF 서체들은 특히 저분해능장치들에서 우수한 읽기능력을 주기 위하 
여 원활한 비가명식서체들로서 묘사될수 있다 . 원활한 서체와 원활하지 않은 서체들사이의 
차이는 아래에 설명한다 . (차이를 보려면 자기 현시기를 저분해능으로 바꾸어야 한다 .) 

Unsmooth 

그림 9-1 원활하지 않은 서 체 


Smooth 

그림 9-2 . 원활한 서 체 

4. 유니코드 

Qt/Embedded 에서 사용하는 모든 서체는 유니코드문자부호화를 사용한다 . 오늘 
사용할수 있는 대부분의 서체들은 이 부호화를 사용하지만 그것들은 보통 유니코드문자 
들을 모두 포함하지 않는다 . 완전한 16point 유니코드서체는 1MB 이상의 기억기를 사용 
한다 . 


5. 서체정의파일 

Qt/Embedded 응용프로그람들을 실행할 때 $QTDIR/1 比 )/ fonts/fontdir 혹은 
/usr/local/qt-embedded/1 化 / fonts/fontdir •라는 파일을 탐색한다 . 이 파일은 응용프 
로그람에 쓸수 있는 서체들을 정의한다 . 그것은 다음의 형식을 가진다 . 
name file Tenderer italic weight size flags 
여기서 파일의 매개 마당의 값들은 표 9-4 와 갈다 . 


표 9-4. _ 파일의 마당값 


마당 

값 

name 

Helvetica, Times, 등 . 

file 

helvR0810.bdf, verdana.ttf 등 . 


280 




마당 

값 

Tenderer 

BDF 혹은 FT 

italic 

Y 혹은 n 

weight 

50 은 표준이고， 75 은 강조 등. 

size 

비 례 가능일 때 0 혹은 점크기 * 10 (즉 12 pt 일 때 
120) 

flags 

• S ： 원활 (비별명식) 

• u : 보관할 때 유니코드범위(기정은 Latin -1) 

• a : 보관할 때 ASCII 범 위 (기 정 은 Latin -1) 


서 체정의 파일은 QPF 서 체들을 지정하지 않고 fontdir 파일을 포함하는 등록부로부터 
직접 적재 되며 다음과 같이 이름을 지어야 한다. 즉 name _ size _ weightitalicflag . qpf , 여 
기서 서체정의파일의 마당값들은 표 9-5 와 갈다. 


표 9-5. _서체정의파일의 마당값 


마당 

값 

name 

helvetica , times 등. (소문자에서) 

size 

point size * 10 (즉 12 pt 에 대 하여 120) 

italicflag 

경사체에 대하여 i ， 그렇지 않으면 아무것도 없 
다. 

weight 

50은 표준，75는 강조 등. 


응용프로그람을 -savefonts 지 령행추가선택으로 실행하면 QPF 서체가 아닌 다른 서 
체를 사용하면 대응하는 QPF 파일이 보관된다. 이것은 자기 응용프로그람들의 사용서체 
를 쉽게 찾고 QPF 파일들을 생성하게 하여 Qt/Embedded 로부터 TTF 와 BDF 지 원을 
금지함으로써 혹은 Qt/Embedded 서고원천코드의 kernel / qapplication — qws.cpp 에서 
qws_savefonts 의 초기화를 수정함으로써 자기 응용프로그람들의 기억기사용을 줄일수 
있 다. 기 억 기 절 약의 극단적 인 경 우에 부분적 으로 묘사된 서 체(즉 "Product Name ™" 
의 문자들만)들이 서 체 로부터 요구하는 문자들이라는것 이 확실 하면 이 서 체 들을 보관할 
수 있다. (이 기 능에 대 해서는 QMemoryManager : :savePrerenderedFontO 를 참고 
하시오.) 

6. 알아두기 

서체정의파일，서체파일에 대 한 명명관례 그리 고 QPF 파일들의 형식은 3이후의 
Qt/Embedded 판들에서 다를수 있다. 

각이한 회 전의 QPF 파일 들을 생 성하려 면 프로그람은 QPF 출력 의 필 요한 회 전과 일 
치 하는 방향으로 재 실행 해 야 한다. 서체 들의 4개 회 전 모두를 생성하는 실례 는 실제 틀 
완충기 에 서 다음과 같은것 을 실 행 하는것 이 다: 

for dpy in LinuxFb Transformed : Rot 90 Transformed : Rotl 80 
T ransf ormed : Rot 2 70 
do 

QWS _ DISPLAY=$dpy . /makeqpf "$ S " 
done 

프로그람들이 한 장치에 대하여 한 방향으로만 실행된다면 하나의 적당한 서체모임 
이 요구된다. 

허용될 때 Qt/Embedded 는 강력한 FreeType 2 서고를 사용하여 TrueType 와 
Typel 지원을 실현한다. 


281 






제 9 절 . Qt/Embedded 위치지정장치조종 

Qt/Embedded 에서 위치지정장치조종은 손접촉조종반과 추적구와 같은 마우스나 
마우스형 장치에서 작업한다. 

보통 오직 하나의 위치지정장치조종만 매몰형장치에 유지되지만 실례를 보여주기 
위 하여 Qt/Embedded 는 많은 량의 지원장치들을 포함한다. 

1. 마우스규약 

마우스구동기들은 환경스크립트를 거처서 허용 또는 금지될수 있다. ./configure 
-help 라고 실행하여 유효한 마우스구동기들을 렬거한다. 기정에서는 pc 마우스구동기만 
이 허용된다. 

pc 마우스구동기를 허용함으로써 Qt/Embedded 는 마우스구동기가 / dev/psaux 에 
서 유지된 형들중 하나이거나 / dev/tty 직렬형들중 하나라면 마우스형과 장치를 자동람 
지 한다. 여 러개의 마우스를 탐지 하면 모두 동시 에 사용할수 있다. 

또한 환경변수 QWS _ MOUSE_PROTO 를 설정하여 사용하려 는 마우스를 결정할수 
있 다. 이 환경변수를 다음과 같이 설정할수 있 다. 

입 protocol 〉 : < device > 

여기서 〈 protocol 〉 는 다음 값들중 하나이다. 

• MouseMan 

• IntelliMouse 

• Microsoft 

〈 device 〉 는 마우스장치 보통 / dev/mouse 이다. 그러 한 변수를 지정 하지 않으면 
기정값은 Auto 이고 이것은 마우스규약과 장치를 자동람지하게 한다. 

다른 규약을 추가하려면 QWSMouseHandler 와 QMouseDriverPlugin 의 새로운 
파생클라스들을 만들고 플라그인으로 설치할수 있다. 

2. 손접촉조종반 

Qt/Embedded 는 NEC Vr 41 XX 손접촉조종판과 iPAQ 와 Zaurus 에서 사용되는 로 
출식 linux 손접촉화면기능을 적재 한다. 이것들은 QWSCal 比) ratedMouseHandler 의 파 
생들라스이고 QWSCaUbratedMouseHandler 는 QWSMouseHandler 의 파생콜라스로 
서 embedded / qmouse _ qws . cpp 에 있다. 

제 10 절 . Qt/Embedded 환경변수 


표 9-6. __ Qt / Embedded 환경 변수 


변 수 

설 명 

QWS _ SW_CURSOR 

하드웨어유표를 유지하는 가속구동프로그람을 사용 
할 때에도 쏘프트웨어마우스유표를 사용한다. 

QWS—DISPLAY 

현시기형과 틀완충기를 정의한다. 실례로 Voodoo 3 
Mach 64：/ dev/fbl 

/ dev / fbO . 에 대 하여 비 가속화된 Linux 틀완충기 구 
동프로그람에 대 한 기 정 값이 다. 유효구동프로그람들 
은 QVfb , VGA 16, LinuxFb (비가속 Linux 틀완충 
기)， Mach 64 (Rage Pro 와 같은 ATI Mach 64 카 
드용으로 가속화됨)， Voodoo 3(3 dfx Voodoo 3용 
으로 가속화됨 . 또한 Voodoo Banshee 에서 작업 해 
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제 11 절 . 자기의 응용프로그람을 Qt/Embedded 에 이식 

가동환경에 의존하는 코드가 없는 현존 Qt 응용프로그람들은 이식을 제공할것을 요구 
하지 말아야 한다. 가동환경 에 의존하는 코드는 기 초하고있는 창문체 계 (Windows 혹은 
XII )에 로의 호출인 체 계 호출과 QApplication ：: xllEventFilterO ^]- 같은 Qt 가동환경 
에 고유한 메 쏘드를 포함한다. 

가동환경에 고유한 코드를 사용할 필요가 있는 경우에 #ifdef 지령에 의하여 각 가 
동환경 에 대 하여 코드를 허용 및 금지하는데 쓰일수 있는 정의된 마크로들이 있다. 


표 9-7. 이식과 관련한 정의된 마크로 


가동환경 

마크로 

Qt/Xll 

Q _ WS _ X 11 

Qt/Windows 

Q _ WS_WIN 

Qt/Embedded 

Q _ WS_QWS 


또한 Qt / Embedded 는 응용프로그람들을 를파일할 때 다음의 기발들을 정의할것을 
요구한다. 

-DQWS - fno-exceptions - fno-rtti 

례외와 RTTI 는 크기와 속도에서 큰 추가비용을 요구하므로 Qt / Embedded 에서 
허용되지 않는다. 


제 12 절 . Qt/Embedded 를 이식할 때 알아야 할 문제 

Qt / Embedded 는 가동환경에 의존하지 않도록 설계된다. 오직 공개적으로 사용할 
수 있는 판은 Linux 실현이다. 다음과 같은 의존관계는 다른 조작체계에 이식하려는 경 
우에 설명할 필요가 있다. 

• System V IPC (공유기억기와 쎄마퍼)는 의뢰기와 봉사기사이에 창문령역들을 공 
유하는데 리 용된다. 단일 응용프로그람설 치(즉 봉사기 인 오직 하나의 프로그람의 실행 )를 
요구하지 않으면 류사한것을 제공할 필요가 있다. 또한 System V 쎄마퍼는 틀완충기의 
동기호출에 사용된다. 

qwindowsy stem _ qws . cpp , q ws regionmanager _ qws . cpp , 

qapplication _ qws . cpp , 그리 고 qlock _ qws . cpp 를 수정 한다. 

• Unixf 역소케트는 응용프로그람들사이 에서 건반사건들과 창문， QCOP 통보문들 
을 발생시킬데 대한 요구를 전송하는데 사용된다. 또한 단일응용프로그람설치를 요구하 
지 않으면 류사한것을 제공할 필요가 있다. 통보문대기렬이나 그와 류사한 기구들을 리 
용하여 이 와 같은것 을 실현할수 있 어 야 하며 QCOP 통보문 (의 뢰기 응용프로그람과 
Qt / Embedded 아닌 응용프로그람들에 의하여 생성되는것)을 제외하고 개별적 통보문들 
은 여러 바이트의 길이만 가져야 한다. 

qwssocket _ qws . cpp 를 수정 한다. 

•Linux 틀^충장치는 그리기령역에서 변환하는데 쓰인다. 기억기변환된 틀완충기 
에 로의 바이 트지 적 자와 폭과 높이 그리 고 비 트깊 이 에 대 한 정 보(간단히 고정 코드작성할 
수 있는것)를 주는 다른것들로 ( QScreen 의 새 콜라스를 창조하여) 그것을 교체할 필 
요가 있다. 자기의 틀완충기가 기 억기변환되지 않거나 유지안된 형식 이나 깊이가 아니면 
QGfxRaster 도 수정 해 야 한다. 

qgfxlinuxfb _ qws . cpp 를 수정 한다. 

• 가속구동프로그람들은 현재 Linux QScreen 을 리 용하며 / proc / bus / pci 를 사용 
하여 PCI 환경공간에서 사영한다. 그러 나 이것들은 오직 실례구동프로그람들뿐이고 임의 
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의 경우에 아마 자체의 구동프로그람을 쓸 필요가 있으며 조종등록기들에서 자체의 사 
영 방법 을 제공해 야 한다. 

qgfxmach 64_ qws . cpp , qgfxvoodoo _ qws . cpp 그리고 qgfxmatrox _ ciws . cpp 를 
수정 한다. 

•음성은 Linux / dev / dsp 형식의 장치를 사용한다. Qt / Embedded 음성 봉사기를 
사용하려고 한다면 그것을 재정의해야 한다. 
qsoundqss _ qws . cpp 를 수정한다. 

• selectO 는 QSocketDevice 들을 실현하고 Qt / Embedded 봉사기응용프로그람들 
에 오고가는 사건들을 접수하는데 쓰인다. 
qapplication _ qws . cpp 를 수정한다. 

Qt / Embedded 는 표준 C 서고와 일부 Posix 함수들을 사용하게 한다. 주로 Posix 함 
수들은 가동환경에 의존하는 코드(실례로 Linux 틀완충기에서 사영하는데 mmapO ) 에 
집중된다. 


제 13 절 . Qt/Bnbedded 성능조정 

저전원장치 들에 서 매 몰형응용프로그람들을 구축할 때 탁상응용프로그람환경 에 서 고 
려할수 없는 많은 선택을 사용할수 있다. 이 선택들은 다음 인자들을 희생시키여 기억기 
와 CPU 요구를 줄인다. 

1. 일반적인 프로그람작성형식 

대화칸와 창문부품들을 필요할 때마다 창조하고 삭제하지 않고 일단 창조한 다음 
QWidget :: hide 0 및 QWidget : : show () 를 호출하여 은페 하거 나 표시한다. 이것은 기 
억기를 좀 더 많이 사용하지만 훨씬 더 고속이다. 

2. 정적련결 대 동적련결 

많은 CPU 와 기 억 기는 ELF 결합처 리 에 의하여 리 용된다. 한조의 응용프로그람을 
정 적구축하여 기 억 기를 절 약할수 있다. 이것은 동적서고 ( libqte . so ) 와 그 서 고에 동적 으로 
련결 하는 실 행 파일 들의 집 합을 가지 는것 보다 모든 응용프로그람들을 하나의 실 행파일 로 
구축하고 그것을 정 적서고 ( libqta ) 에 정 적 으로 련결한다는것 을 의 미한다. 이것은 기동시 
간을 줄이고 기 억 사용량을 줄이 지 만 유연성 을 떨 구고(새 응용프로그람을 추가하려 면 하 
나의 실 행파일 을 재 름파일 해 야 한다. ) 른튼하지 못하다 (하나의 응용프로그람에 오유가 
있으면 다른 응용프로그람들을 상하게 할수 있다) . 말단사용자응용프로그람을 설치해 야 
한다면 이것은 선택하지 않을수 있으나 제 한된 CPU 능력 과 기 억 기를 가지는 장치 용으로 
하나의 응용프로그람을 구축하는 경 우에 는 이 선택 이 아주 유리하다. 

정 적서 고로서 Qt 를 롬파일하려 면 configure 를 실행할 때 - static 선택 을 추가한다. 

응용프로그람조를 모두 하나의 응용프로그람으로 구축하려면 매개 응용프로그람을 
main 0함수에 최소의 코드만 가지는 독자의 창문부품이나 창문부품모임으로 설계한다. 
그다음 응용프로그람들사이를 절환하는 방법(실례로 QlconView ) 을 주는 응용프로그람 
을 쓴다. Qtopia 가 그 실례 이 다. 그것은 일 련의 동적련결실행 파일들로서 혹은 하나의 
정 적 응용프로그람으로서 구축될 수 있 다. 

일반적으로 아직 표준 C 서고와 자기 장치에서 다른 응용프로그람들이 사용할수 있는 
다른 서 고들에 대 해 서 만 동적 으로 련결해 야 한다. 

3. 다른 기억할당 

일부 가동환경들에서 C ++ 콤파일러들이 적재하는 서고들은 new 와 delete 연산자들 
의 기능이 빈약하므로 이 함수들을 재정의하여 성능을 높일수 있다. 실례로 자기 코드에 
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다음과 같이 추가하여 보통의 C 할당자들로 절환할수 있다. 
void * operator new [] ( size_t size ) 

{ 

return malloc ( size 5 j 

} 

void * operator new ( size_t size ) 

{ 

return malloc ( size ); 

} 

void operator delet 法 0 ( void *p ) 

{ 

free ( p ); 

} 

void operator deleted ( void * p , size_t size ) 

{ 

free ( p ); 

} 

void operator delete ( void *p ) 

{ 

free ( p ) : 

} 

void operator delete ( void * p , size_t size ) 

{ 

free ( p ) : 


제 14 절 . VNC 봉사기로서의 Qt/Embedded 

VNC 규약은 망의 어디서나 롬퓨터의 현시기에 표시하고 대화할수 있게 한다. 

이러한 방법으로 Qt / Embedded 를 사용하려면 - qt - gfx - vnc 선택을 지정하여 Qt 의 
환경을 구성하고 16 bit 현시기유지가 가능하다는것을 담보한다. 다음과 같이 자기의 응용 
프로그람을 실행한다. 

application -display VNC ：0 

그다음 자기 응용프로그람을 실행 하고있는 름퓨터 에서 VNC 의 뢰기위치지정 을 실행 
한다. 실례로 Xll VNC 의뢰기를 리용하여 같은 를퓨터로부터 응용프로그람을 표시한다. 
vncviewer localhost ：0 

기정으로 Qt / Embedded 는 640 x 480 화소의 현시기를 창조하다. QWS _ SIZE 환경 
변수를 다른 크기 실례 로 QWS _ SIZE =240 X 320 으로 설정하여 이것을 변경할수 있다. 

VNC 의뢰기들은 현시기체계(즉 XII 과 Windows , Amiga , DOS , VMS , 기타)들 
의 거대한 배렬에 사용할수 있다. 

Qt 가상틀완충기는 다른 기술이 다. 그것은 공유기억기를 사용하므로 훨씬 더 빠르고 
원활하지만 망에서는 조작하지 않는다. 
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부록 1. Qt 클라스서고 


1. Qt 의 기본클라스들 

제 일 흔히 사용하는 Qt 클라스들은 다음과 같다. 


QAction 

QFileDialog 

QMessageBox 

QSlider 

QTimer 

QApplication 

QFont 

QMovie 

QSound 

QToolBar 

QButtonGroup 

QFontDialog 

QNetworkP rotocol 

QSpinBox 

QToolBox 

QCanvas 

QGLWidget 

QObject 

QSplashScree 

n 

QToolButton 

QCheckBox 

QGridLayout 

QPainter 

QSplitter 

QToolTip 

QClipboard 

QGroupBox 

QPalette 

QSql 

QTranslator 

QColorDialog 

QGuardedPtr 

QPen 

QSqlDatabase 

QUrl 

QComboBox 

QHBoxLayout 

QPixmap 

QSqlDriverPl 

ugin 

QUrlOperator 

QDataBrowser 

QlconSet 

Q Point 

QSqlForm 

QValidator 

QDataTable 

QlconView 

QPopupMenu 

QSqlQuery 

QValueList 

QDataView 

Qlmage 

QPrinter 

QStatusBar 

QValueStack 

QDate 

QInputDialog 

QProcess 

QString 

QValueVector 

QDateEdit 

QLabel 

QProgressBar 

QStringList 

QVariant 

QDateTime 

QLCDNumber 

QProgressDialog 

QTabDialog 

QVBoxLayout 

QDateTimeEdit 

QLibrary 

QPushButton 

QTable 

QWhatsThis 

QDial 

QLineEdit 

QRadioButton 

QTabWidget 

QWidget 

QDialog 

QListBox 

QRect 

QTextBrowse 

r 

QWidgetStack 

QDict 

QListView 

QRegExp 

QTextEdit 

QWizard 

QDir 

QMainWindow 

QScrollView 

QTextStream 

QWorkspace 

QDockWindow 

QMap 

QSettings 

QTime 

QXmlSimpleReade 

QFile 

QMenuBar 

QSimpleRichText 

QTimeEdit 



2. 클라스의 분류 

여기서는 Qt 의 클라스들을 분류한다. 일부 클라스들은 하나이상의 부류에 속할수 있다. 


부류 

설명 

추상창문부품 

파생클라스작성 을 통하여 사용할수 있는 추상창문부품클라스 
들. 

고급한 창문부품 

목록보기와 진척상황띠와 갈은 고급한 GUI 창문부품. 

기 본창문부품 

단추，복합칸，흐름띠와 같은 기본 GUI 창문부품. 

자료기 지 

자료기지 관련콜라스들，실례로 SQL 자료기지 . 

날자와 시간 

날자와 시 간을 처 리하는 클라스들. 

끌기와 놓기 

끌어 다놓기와 mime 형부호화와 복호화를 취급하는 들라스들. 







부류 

설명 

그라픽스와 인쇄 

OpenGL 을 비 롯하여 그리 기 (와 인쇄)기초를 제공하는 클라스 
들. (또한 화상처리와 다매체를 참고) 

방조체 계 

응용프로그람의 직 결방조를 제 공하는데 쓰이 는 클라스들. 

화상처 리 

수자화상 부호화와 복호화, 조작. (또한 그라픽스와 인쇄 및 
다매체를 참고) 

배치 관리 

복잡한 대화칸을 만들기 위하여 창문부품들의 자동크기조절과 
이동을 처리하는 콜라스들. 

암시적 및 명시 
적 

공유클라스 

고속복사에 참고계수를 사용하는 콜라스들. 

입출력과 망구축 

파일 입출력과 등록부와 망조종을 제공하는 콜라스들. 

MainWindow 

및 

관련클라스 

차림표，도구띠, 작업공간 등 전형적이고 현대적인 기본응용 
프로그람창문에 필요한 모든것. 

기타 

여러가지 기타 유용한 콜라스들 

다매 체 

그라픽스，음성，동화상 등에 대한 유지를 제공하는 클라스 
들. (또한 그라픽스와 인쇄 및 화상처 리를 참고) 

객 체 모형 

객체모형에 기초하는 Qt GUI 개발도구. 

조직자 

분할기 , 타브띠，단추그룹 등 사용자대면부조직자들. 

플라그인클라스 

플라그인 관련들라스들 . 

표준대 화칸 

파일，본트，색 선택 등을 위한 준비된 클라스들. 

형판서 고 

Qt 의 형판서고용기콜라스들. 

본문관련콜라스 

본문처 리용 콜라스들. (또한 XML 클라스들을 참고.) 

스레 드클라스 

스레 드유지를 제공하는 클라스들. 

창문부품외 관 

형식，서체，색 등의 외관전용화. 

XML 클라스 

실례로 DOM 과 SAX 를 통하여 XML 을 지원하는 들라스들，. 


1) 추상적 인 창문부품클라스 

이 클라스들은 추상창문부품이므로 보통 자체로 쓰이지 못하지만 계승용으로 
할수 있는 기능들을 제공한다. _ 


QButton 

단추에 대한 일반적인 기능을 제공하는 단추창문부품 
의 추상기초클라스 

QCanvas 

QCanvasItem 객체들을 포함할수 있는 2 D 령역 

QDialog 

대화창문의 기초클라스 

QFrame 

틀을 소유할수 있는 창문부품들의 기초클라스 

QGridView 

크기가 고정된 격자표의 추상기초를라스 

QScrollView 

조종가능한 흐름띠 를 가지 는 흘림령 역 

QWidget 

모든 사용자대 면 부객 체 용 기 초콜라스 

QWizard 

위자드대화칸용 틀거리 


2) 고급한 창문부품들 

다음의 클라스들은 더 복잡한 사용자대면부조작을 제공한다. 




QCheckListltem 

검사가능한 목록보기항목 

QCheckTableltem 

QTable 의 검사칸 

QComboT ableltem 

QTable 에서 복합칸을 사용하는 수단 

QDateEdit 

날자편집기 

QDateTimeEdit 

QDateEdit 과 QTimeEdit 창문부품을 날자시 간편집용 단 
일창문부품에 결합한다. 

QDesktopWidget 

다중 head 체계에서 화면정보에 대한 호출 

QHeader 

표나 목록보기용 머 리부 행 또는 렬 

QIconFactory 

QlconSet 용 픽스매프를 창조하는데 사용 

QlconView 

이동가능한 표식 그림기 호를 가진 령 역 

QlconViewItem 

QlconView 안의 한개 항목 

QListBox 

선택가능한 읽기전용의 항목목록 

QListBoxPixmap 

픽스매프와 선택본문을 가진 목록칸항목 

QListBoxText 

본문을 현시하는 목록칸항목들 

QListView 

목록/나무보기를 실현한다. 

QListViewItem 

목록보기항목을 실현한다. 

QListViewItemlterator 

QListViewItem 들의 집 합용 반복자 

QMultiLineEdit 

본문입력용 단순편집기 

QProgressBar 

수평 진행상황띠 

QTab 

QTabBar 의 구조체들 

QTabBar 

타브띠 실례로 타브형식대화칸에서 사용 

QTable 

유연성있는 편집 가능표창문부품 

QTableltem 

QTable 용 세포항목 

QTableSelection 

QTable 의 선택령 역 에로의 호출 

QTabWidget 

타브형식창문부품들의 탄창 

QTextBrowser 

초본문련결을 가진 리치본문열람기 

QTimeEdit 

시간편집기 

QToolBox 

타브형식창문부품항목들의 렬 


3) 기 초창문부품들 

기본조종요소(창문부품)들은 직접 사용하는것으로 설계된다. 또한 파생클라스 i 
r 기 위 한 추상창문부품클라스들과 그밖에 더 복잡한 창문부품들도 있다. 


QAction 

차림 표와 도구띠 에 나타나는 추상적 인 사용자대 면부작용 

QActionGroup 

작용들을 한 그를에 묶는다. 

QCheckBox 

본문표식을 가진 검사칸 

QComboBox 

본문표식을 가진 복합칸 

QDial 

(속도계나 전위차계와 같은) 원형의 범위조종 

QLabel 

본문 혹은 화상현시 

QLCDNumber 

LCD 형 식 으로 수를 현시한다. 

QLineEdit 

한행 본문편집 기 

QPopupMenu 

올리펼침차림표창문부품 




QSizeGrip 

제 일 웃준위 창문용 구석 격 자 

QSlider 

수직 혹은 수평슬라이더 

QSpinBox 

스핀 칸창문부품 (스핀 단추) 

QSyntaxHighlighter 

QTex 切: dit 문법강조표시 기를 실현하는 기초클라스 

QTextEdit 

강력 한 단일폐지리치본문편집 기 

QToolButton 

QToolBar 안에서 보통 사용되는 지령이나 선택들의 고엄 
출 단추 


4) 자료기 지 클라스 

다음의 클라스들은 SQL 자료기지의 호출을 제공한다. 


QDataBrowser 

자료항목폼에서 자료조작과 항행 

QDataTable 

열람 및 편집을 유지하는 유연성있는 SQL 표 

QDataView 

읽기전용 SQL 폼 

QEditorFactory 

QVariant 자료형용 편집칸창문부품창조에 쓰인다. 

QSql 

대 역일 것 을 요구하는 Qt SQL 식 별 자용 이 름공간 

QSqlCursor 

SQL 표와 보기의 열람과 편집 

QSqlDatabase 

SQL 자료기지 련결을 창조하고 일괄처 리를 제공하는데 
리 용 

QSqlDriver 

SQL 자료기 지 호출용 추상기 초클라스 

QSqlEditorFactory 

QDataTable 과 QSqlForm 에서 리용하는 편집기를 창 
조하는데 리용 

QSqlError 

SQL 자료기 지 오유정 보 

QSqlField 

SQL 자료기지표와 보기들에서 마당을 조작한다. 

QSqlFieldlnfo 

SQL 마당과 련상된 메타자료를 보관한다. 

QSqlForm 

SQL 자료기지에 련결된 자료항목폼을 창조하고 관리한 
다. 

QSqllndex 

QSqlCursor 와 QSqlDatabase 색 인을 조작 및 서술하 
는 기능 

QSqlPropertyMap 

창문부품을 SQL 마당으로 변환하는데 리용 

QSqlQuery 

SQL 명령문의 실행 및 조작수단 

QSqlRecord 

자료기 지레 코드 즉 자료기 지 마당들의 모임 을 은폐 한다. 

QSqlRecordlnfo 

자료기 지 마당메 타자료의 모임 을 은폐한다. 

QSqlResult 

SQL 자료기 지 로부터 자료를 호출하기 위한 추상대 면부 

QSqlSelectCursor 

일반 SQL SELECT 문의 열람 


5) 시 간과 날자 

이 콜라스들은 체계에 의존하지 않는 날자와 시간추상화를 제 i 
또한 다음것을 사용할수 있다. Qt 2000 년호환명 령문. _ 


QDate 

날자함수 

QDateEdit 

날자편집기 

QDateTime 

날자와 시간함수 

QDateTimeEdit 

QDateEdit 와 QTimeEdit 창문부품을 날자시; 
의 창문부품으로 결합한다 

QTime 

시 간함수 

QTimeEdit 

시간편집기 




다음의 클라스들은 끌어 다놓기와 필요한 mime 형 부호화와 복호화를 론의한다. 


QColorDrag 

색들을 전송하기 위한 끌어 다놓기객체 

QDragEnterEvent 

끌어 다놓기가 처음으로 창문부품우로 끌기할 때 그 창문 
부품에 송신되는 사건 

QDragLeaveEvent 

끌어다놓기가 창문부품을 떠날 때 그 창문부품에 송신되 
는 사건 

QDragMoveEvent 

끌어 다놓기가 진행중일 때 송신되는 사건 

QDragObject 

MIME 에 기 초한 자료전송을 은폐한다. 

QDropEvent 

끌어 다놓기 가 끝났을 때 송신되는 사건 

QIconDrag 

QlconView 안에서 끌어 다놓기조작을 유지한다. 

QIconDragltem 

끌기항목을 은폐한다. 

QlmageDrag 

화상을 전송하기 위한 끌어 다놓기 객 체 

QMacMime 

열린표준형 MIME 를 Mac 형 식 으로 변환한다. 

QMimeSource 

일정한 MIME 형의 형 식 화된 자료를 제 공하는 객체 들의 
추상화 

QStoredDrag 

임의의 MIME 자료를 위한 간단히 기 억값끌기객체 

QTextDrag 

일 반본문과 유니 코드본문을 변환하기 위한 끌어 다놓기 객 
체 

QUriDrag 

URI 참고목록용 끌기객체 

QWindowsMime 

공개표준 MIME 를 Window 오려둠판형식으로 변환한다. 


7) 환경 클라스 

다음의 클라스들은 사건조종，체계설정，국제화와 같은 여러가지 대역봉사를 공 


로그람에 제공한다. 


QClipboard 

창문체계오려 둠판에 대한 호출 

QDesktopWidget 

다중헤 드체 계 상에 서 화면 정 보호출 

QEvent 

모든 사건믈라스들의 기초클라스. 사건객체는 사건파라 
메터 들을 포함한다. 

QFontDatabase 

기본창문체계 에서 사용할수 있는 서체에 대한 정보 

QMimeSou rceF acto ry 

MIME 형자료의 확장가능한 제 공기 

QMutex 

스레 드들사이 의 호출계 렬 화 

QMutexLocker 

QMutexe 의 잠그기와 해제를 간단화한다. 

QPixmapCache 

픽스매프용의 응용프로그람대역캐쉬 

QSemaphore 

건전한 완전쎄마휘 

QSessionManager 

쎄숀관리기 에 대 한 호출 

QThread 

가동환경에 의존하지 않는 스레드 

QThreadStorage 

스레드별 자료기억 

QTranslator 

본문출력 을 위한 국제 화지원 

QT ranslatorMessage 

번역기통보문과 그 속성들 

QWaitCondition 

스레드들사이의 조건들에 대 한 대기/동작 ( waking ) 을 
허용한다. 








8) 사건클라스 

다음의 클라스들은 사건의 창조와 조종에 리용된다. 


QChildEvent 

자식 객 체 사건들을 위 한 사건파라메 터 

QCloseEvent 

닫기사건을 서술하는 파라메 터 

QContextMenuEvent 

상황차림 표사건을 서 술하는 파라메 터 들 

QCustomEvent 

사용자정의사건지원 

QDragEnterEvent 

끌어 다놓기 가 처음으로 창문부품우로 끌기 할 때 그 창 
문부품에 송신되는 사건 

QDragLeaveEvent 

끌어 다놓기 가 창문부품을 떠 날 때 그 창문부품에 송신 
되는 사건 

QDragMoveEvent 

끌어 다놓기 가 진행중일 때 송신되는 사건 

QDropEvent 

끌어 다놓기가 끝났을 때 송신되 는 사건 

QEvent 

모든 사건클라스들의 기초믈라스. 사건객체는 사건파라 
메 터 들을 포함한다. 

QEventLoop 

사건대기렬을 관리한다. 

QFocusEvent 

창문부품초점 사건의 사건파라메 터 

QHideEvent 

창문부품이 은폐된 후 전송되는 사건 

QIconDragEvent 

기본그림기호끌기 를 시작한 신호 

QIMEvent 

입 력 메 쏘드사건용 파라메 터 들 

QKeyEvent 

건사건을 서술한다. 

QMouseEvent 

마우스사건을 서 술하는 파라메 터 

QMoveEvent 

이동사건을 위한 사건파라메 터 

QPaintEvent 

그리기사건을 위한 사건파라메 터 

QResizeEvent 

크기 조절사건용 사건파라메 터 

QShowEvent 

창문부품이 표시될 때 송신되는 사건 

QTabletEvent 

Tablet 사건을 서 술하는 파라메 터 

QTimer 

시계신호와 단일소리시계 

QTimerEvent 

시 계 사건을 서 술하는 파라메 터 

QWheelEvent 

바퀴 사건을 서 술하는 파라메 터 들 


9) 비 GUI 클라스들 

비 GUI 들라스들은 GUI 클라스들과는 독립적으로 사용할수 있는 일반목적집합고 
자렬클라스들이 다. 

특히 이 콜라스들은 QApplication 에 전혀 의존되지 않으므로 비 GUI 프로그림 


서 사용할수 있다. 


QAsciiCache 

char * 건에 기초한 캐쉬를 제공하는 형판클라스 

QAsciiCachelterator 

QAsciiCache 집합용 반복자 

QAsciiDict 

char * 건에 기초한 사전을 제공하는 형판콜라스 

QAsciiDictlterator 

QAsciiDict 집합용 반복자 

QBitArray 

비 트배 렬 

QByteArray 

바이트배렬 

QCache 

QString 건에 기초한 캐쉬를 제공하는 형판클라스 

QCachelterator 

QCache 집합용 반복자 







QDeepCopy 

암시적공유와 명시적공유클라스들이 유일한 자료를 참 
고한다는것 을 담보하는 형 판클라스 

QDict 

QString 건에 기초한 사전을 제공하는 형판클라스 

QDictlterator 

QDict 집합의 반복자 

QIntCache 

긴열쇠에 기초하는 캐쉬를 제공하는 형판클라스 

QIntCachelterator 

QIntCache 집합의 반복자 

QIntDict 

긴열쇠에 기초하는 등록부를 제공하는 형판콜라스 

QIntDictIterator 

QIntDict 집합의 반복자 

QMap 

사전을 제공하는 값에 기초한 형판콜라스 

QMapConstlterator 

QMap 의 상수반복자 

QMapIterator 

QMap 의 반복자 

QMemArray 

단순형배렬을 제공하는 형판콜라스 

QObjectList 

QObject 들의 QPtrList 

QObjectListlterator 

QObjectList 용 반복자 

QPair 

한쌍의 원소들을 제공하는 값기초형 판클라스 

QPtrCol lection 

대다수 지적자에 기초한 Qt 집합의 기초콜라스 

QPtrDict 

void * 건에 기초하는 사전을 제공하는 형판클라스 

QPtrDictlterator 

QPtrDict 집합용 반복자 

QPtrList 

목록을 제공하는 형판들라스 

QPtrListlterator 

QPtrList 집합용 반복자 

QPtrQueue 

대 기렬을 제 공하는 형 판들라스 

QPtrStack 

탄창을 제공하는 형 판클라스 

QPtrVector 

벡토르(배럴)을 제공하는 형판집합 

QRegExp 

정규식들을 사용한 패런대조 

QStrIList 

대소문자식별비교기능을 가진 char * 의 2중련결목록 

QString 

유니코드본문과 전형적 인 C 의 ’\0’완료문자배럴의 추 
상화 

QStringList 

문자렬 목록 

QStrList 

char * 의 2중련결목록 

QStrListlterator 

QStrList 와 QStrIList 콜라스들의 반복자 

QValueList 

목록을 제공하는 값기초형판들라스 

QValueListConstlterat 

or 

QValueList 의 상수반복자 

QValueListlterator 

QValueList 의 반복자 

QValueStack 

탄창을 제공하는 값기초형판를라스 

QValueVector 

동적배 럴을 제 공하는 값기 초형 판콜라스 


10 ) 그라픽 스클라스들 

다음의 콜라스들은 2 D 와 
한다. 

( OpenGL 에 의 한) 3 D 용의 강력 한 그라픽 스그리 기 를 제 공 

QBitmap 

흑백픽스매프 (1 bit 깊이) 

QBrush 

QPainter 로 그려질 도형들의 도색패턴을 정의한다. 

QCanvas 

QCanvasItem 객체를 포함할수 있는 2 D 령역 





QCanvas 상의 추상도형객체 


QCanvasItem 


QCanvasItemList 

QCanvasItem 들의 목록 

QCanvasLine 

QCanvas 상의 직선 

QCanvasPixmap 

QCanvasSprite 용 픽스매프 

QCanvasPixmapArray 

QCanvasPixmap 배 렬 

QCanvasPolygon 

QCanvas 상의 다각형 

QCanvasPolygonalltem 

QCanvas 상의 다각형그림항목 

QCanvasRectangle 

QCanvas 상의 직4각형 

QCanvasSpline 

QCanvas 상의 다중베쎌 spline 

QCanvasSprite 

QCanvas 상의 동화그림항목 

QCanvasText 

QCanvas 상의 본문객체 

QCanvasView 

QCanvas 의 화면보기 

QColor 

RGB 혹은 HSV 값에 기초한 색 

QColorDialog 

색 을 지 정 하기 위한 대 화칸창문부품 

QColorGroup 

창문부품색의 그룹 

QDirectPainter 

비 데오하드웨 어 의 직 접호출 

QFont 

본문그리기 에 사용하는 서체 

QFontDatabase 

기 본창문체 계 에서 사용할수 있는 서 체 에 대 한 정 보 

QFontlnfo 

서체에 대한 일반적 정보 

QFontMetrics 

서 체 크기 정 보 

QGL 

Qt OpenGL 모둘에 서 여 러 가지 식 별 자를 위 한 이 름공간 

QGLColormap 

QGLWidget 들에 사용자정 의 색 략도를 설 치하는데 쓰인 다. 

QGLContext 

OpenGL 묘사상황을 은페 한다. 

QGLFormat 

OpenGL 묘사상황의 현시형식 

QGLWidget 

OpenGL 그라픽스묘사용 창문부품 

QlconSet 

여러가지 형식과 크기의 그림기호모임 

Qlmage 

화소자료에 대 한 직 접호출을 가진 하드웨 어독립픽스매 프표 
시 

QlmageConsumer 

QlmageDecoder 에 의하여 사용되 는 추상화 

QlmageDecoder 

유지되 여 있는 모든 화상형 식 의 증분식 화상해 신기 

QlmageFormat 

특수화상형 식 의 증분식 화상해 신기 

QlmageFormatT ype 

QlmageFormat 객체를 만드는 공장 

QlmagelO 

화상의 적재와 보관용 파라메터 

QMovie 

동화상이 나 정 지 화상의 적재 상황을 신호하는 증분식 적재 

QPaintDevice 

그리기 할수 있는 객체 들의 기 초콜라스 

QPaintDeviceMetrics 

그리기장치에 대한 정보 

QPainter 

창문부품들에 대 한 저수준그리기 를 한다. 

QPalette 

매개 상태를 위한 색그룹 

QPen 

QPainter 가 직선과 륜곽선을 그리는 방법을 정의한다. 

QPicture 

QPainter 지령을 기록하고 재연시하는 그리기장치 

QPixmap 

비직결화면，화소에 기초한 그리기장치 

QPixmapCache 

픽스매프용의 응용프로그람대역캐쉬 

QPNGImagePacker 

잘 압축된 PNG 동화상을 창조한다. 

QPoint 

평면안의 점을 정의한다. 






QPointArray 


점들의 배렬 


QPrinter 

인쇄기 에 그리는 그리기장치 

QRect 

평면안의 직사각형 을 정의 한다. 

QRegion 

그리기프로그람용의 복사칸 ( clip ) 령역 

QSize 

2차원객체의 크기를 정의한다. 

QStyleSheet 

리치 본문묘사용의 형 식 들의 집 합과 타그생 성 기 

QWMatrix 

자리표계의 2 D 변환 


11) 방조체 계 

다음의 들라스들은 자기의 응용프로그람에서 직결방조의 모든 형식을 3준 
히 제공한다. 

1. 도구암시와 상태띠통보는 매우 가볍고 극히 간단하며 사용자대면부에 
통합되 여있으며 호출하기 위한 사용자교제 가 적거 나 없을것을 요구한다. 

2. What’s This ? 는 매우 간단한 설명이다. 

3. 직결방조는 임의의 량의 정보를 포함할수 있으나 호출속도가 뜨고 시 
업 과 분리 되 여있 다. 


QStatusBar 

상태정보를 표시하는데 적합한 수평띠 

QStyleSheet 

리치 본문묘사용의 형 식 들의 집 합과 타그생 성 기 

QTextBrowser 

초본문항행 이 가능한 리치본문열 람기 

QToolTip 

임의의 창문부품을 위한 도구암시 (풍선형 방조) 혹은 창문부 
품의 직4각형부분 

QToolTipGroup 

도구암시들을 관련된 그룹들로 집합한다. 

QWhatsThis 

《이것은 무엇인가?》와 갈은 질문에 대답하는 임의의 창문 
부품의 간단한 서술 


12) 화상처 리 클라스 

이 콜라스들은 화상조작에 사용된다. 


QBitmap 

흑백픽스매프 (1 bit 깊이) 

QBrush 

QPainter 로 그려질 도형들의 도색패 턴을 정의한다. 

QCanvas 

QCanvasItem 객체를 포함할수 있는 2 D 령역 

QCanvasEllipse 

QCanvas 상의 타원 혹은 타원토막 

QCanvasItem 

QCanvas 상의 추상도형 객체 

QCanvasItemList 

QCanvasItem 들의 목록 

QCanvasLine 

QCanvas 상의 직선 

QCanvasPixmap 

QCanvasSprite 용 픽스매프 

QCanvasPixmapArray 

QCanvasPixmap 배 렬 

QCanvasPolygon 

QCanvas 상의 다각형 

QCanvasPolygonalltem 

QCanvas 상의 다각형그림항목 

QCanvasRectangle 

QCanvas 상의 직4각형 

QCanvasSpline 

QCanvas 상의 다중베쎌 스플라인 

QCanvasSprite 

QCanvas 상의 동화그림천항목 

QCanvasText 

QCanvas 상의 본문객체 

QCanvasView 

QCanvas 의 화면보기 

QColor 

RGB 혹은 HSV 값에 기초한 색 




QColorGroup 

창문부품색의 그롭 

QGL 

Qt OpenGL 모둘에서 여 러 가지 식별 자를 위 한 이름공간 

QGLColormap 

QGLWidget 들에 사용자정 의 색 략도를 설 치 하는데 쓰인 
다. 

QGLContext 

OpenGL 묘사상황을 은폐한다. 

QGLFormat 

OpenGL 묘사상황의 현시형식 

QGLWidget 

OpenGL 그라픽스묘사용 창문부품 

QlconSet 

여러가지 형식과 크기의 그림기호모임 

Qlmage 

화소자료에 대한 직접호출을 가진 하드웨어독립픽스매 
프표시 

QlmageConsumer 

QlmageDecoder 에 의 하여 사용되는 추상화 

QlmageDecoder 

유지되 여있는 모든 화상형 식 의 증분식화상해 신기 

QlmageFormat 

특수화상형식의 증분식화상해신기 

QlmageFormatT ype 

QlmageFormat 객체를 만드는 공장 

QlmagelO 

화상의 적재와 보관용 파라메터 

QMovie 

동화상이나 정지화상의 적재상황을 신호하는 증분식적 
재 

QPaintDevice 

그리기 할수 있는 객체들의 기초콜라스 

QPaintDeviceMetrics 

그리기장치에 대한 정보 

QPainter 

창문부품들에 대 한 저수준그리기 를 한다. 

QPalette 

매개 창문부품상태를 위한 색그룹 

QPen 

QPainter 가 직선과 륜곽선을 그리는 방법을 정의한다. 

QPicture 

QPainter 지 령을 기록하고 재 연시 하는 그리기장치 

QPixmap 

비직결화면，화소에 기초한 그리기장치 

QPixmapCache 

픽스매프용의 응용프로그람대역캐쉬 

QPNGImagePacker 

잘 압축된 PNG 동화상을 창조한다. 

QPoint 

평면안의 점을 정의 한다. 

QPointArray 

점들의 배럴 

Qprinter 

인쇄기에 그리는 그리기장치 

Qrect 

평면안의 직사각형을 정의 한다. 

Q region 

그리기프로그람용의 복사칸 ( clip ) 령역 

Qsize 

2차원객체의 크기를 정의 한다. 

QWMatrix 

자리표계의 2 D 변환 


13) 배 치 관리 

다음의 클라스들은 창문부품들의 자동기 하학적 (배 치 ) 관리 를 제 공한다. 


QBoxLayout 

자식 창문부품들을 수평 혹은 수직으로 배 치 한다. 

QButtonGroup 

QButton 창문부품들을 한 그룹으로 구성한다. 

QGLayoutlterator 

내부배치관리자반복자들의 추상기초들라스 

QGrid 

자식들의 단순한 기하학적관리 

QGridLayout 

창문부품을 격 자형 식 으로 배 치한다. 

QGroupBox 

제목있는 그롭칸프레임 

QHBox 

자식창문부품들의 수평기하학적관리 







15) 입 줄력 과 망프로그람작성 

다음의 콜라스들은 외부장치，프로쎄스，파일로부터 입출력을 조종하며 파 
록부에 대하여 조작한다. 


QBuffer 

QByteArray 에서 조작하는 I/O 장치 

QClipboard 

창문체계오려둠판에 대한 호출 

QDataStream 

2진자료를 QIODevice 에로의 계렬화 

QDir 

가동환경 에 의존하지 않는 등록부구조와 그 내용호출 

QDns 

비 동기 DNS 감시 

QFile 

파일 에 조작하는 입 출력장치 

QFilelnfo 

체계에 의존하지 않는 파일정보 

QFtp 

FTP 통신규약의 실현 

QHostAddress 

IP 주소 

QHttp 

HTTP 통신규약의 실현 

QHttpHeader 

HTTP 용 머리부정보 

QHttpRequestHeader 

HTTP 용 요구머리부정보 

QHttpResponseHeader 

HTTP 용 응답머 리부정보 

QlmagelO 

화상의 적재와 보관용 파라메터 

QIODevice 

1/◦장치들의 기초들라스 

QLocalFs 

국부파일체계에서 작업하는 QNetworkProtoc 이의 
실현 

QMacMime 

열린표준형 MIME 를 Mac 형 식 으로 변환한다. 

QMimeSource 

일정한 MIME 형의 형 식 화된 자료를 제 공하는 객 체들 
의 추상화 

QMimeSourceFactory 

MIME 형자료의 확장가능한 제 공자 

QNetworkOperation 

망을 위한 일 반조작 

QNetworkProtocol 

망용의 일반 API 

Q Process 

외 부크로그람들을 기 동하고 그것 들과 교제 하는데 리 
용 

QServerSocket 

TCP 에 기초한 봉사기 

QSettings 

가동환경에 의존하지 않는 영속적 인 응용프로그람환 
경설정 

QSignal 

QObject 를 계승하지 않는 클라스에 신호를 보낼 때 
리 용 

QSignalMapper 

식 별가능한 송신자들로부터 오는 신호들을 묶는다. 

QSocket 

완충형 TCP 련결 

QSocketDevice 

가동환경에 의존하지 않는 저수준소케트 API 

QSocketNotifier 

소케트역호출용으로 제공 

QTextIStream 

입력스트림용 편의클라스 

QTextOStream 

출력스트림용 편의콜라스 

QTextStream 

QIODevice 를 사용하여 본문을 읽고 쓰는 기본함수들 

QUrl 

URL 문법해석기와 그의 간단한 동작 

QUrllnfo 

URL 에 대 한 정보를 보관한다. 

QUrlOperator 

일반적인 URL 조작 

QWindowsMime 

공개표준 MIME 를 Window 오려둠판형식으로 변환한다. 





16) 기 본창문과 관련 한 클라스들 

다음의 클라스들은 기본창문자체와 차림표띠，도구띠，상태띠와 같이 현대적인 기본 


응용프로그람창문에 필요한 모든것 을 제 공한다. 


QAction 

차림 표와 도구띠 에 나타날 사용자대 면부작용을 요약한다. 

QActionGroup 

작용들을 한 그룹에 묶는다. 

QApplication 

GUI 응용프로그람의 조종흐름과 기 본설정 을 관리한다. 

QDockArea 

QDockWindow 들을 관리 하고 배 치한다. 

QDockWindow 

QDockArea 안에서 류동할수 있거나 탁상우의 제일 웃준위 
창문으로 될수 있는 창문부품 

QEventLoop 

사건대기렬을 관리한다. 

QMainWindow 

차림표띠 류동가능창문(례를 들면 도구띠)，상태띠가 있는 
기본응용프로그람창문 

QMenuBar 

수평 차림 표띠 

QPopupMenu 

올리펼침차림표창문부품 

QSessionManager 

쎄손관리기에 대한 호출 

QSizeGrip 

제 일웃준위창문용 구석 격 자 

QStatusBar 

상태정보를 표시하는데 적합한 수평띠 

QToolBar 

도구단추와 갈은 창문부품들을 포함하는 이 동가능조종판 

QWorkspace 

MI)I 용과 갈은 장식창문을 포함할수 있는 작업공간창문 


17) 다매 체 클라스 

다음의 클라스들은 그라픽스，음성，동화상 등의 기능을 제공한다. 


QlmageConsumer 

QlmageDecoder 에 의해 사용되는 추상화 

QlmageDecoder 

유지 하고있는 모든 화상형식들의 증분식 화상해 신기 

QlmageFormat 

특정 한 화상형 식 의 증분식 화상해 신 기 

QlmageFormatT ype 

QlmageFormat 객체들을 만드는 공장 

QMovie 

동화상 혹은 화상들의 증분식적재，그 과정의 신호 
화 

QSound 

가동환경음성편의의 호출 


18) 객 체 모형 

다음의 클라스들은 Qt 객 체모형 의 기 초이 다. 


QGuardedPtr 

QObject 에 로의 감시 ( guarded ) 지 적 자를 제 공하는 
형판클라스 

QMetaObject 

Qt 객 체 에 대 한 메 타정 보 

QMetaProperty 

속성에 대 한 메 타정보를 보관한다. 

QObject 

모든 Qt 객체들의 기초클라스 

QObjectCleanupHandler 

여 러 QObject 들의 수명을 감시한다. 

QVariant 

가장 일 반적 인 Qt 자료형 들을 위한 공용체 와 같이 
동작한다. 


19) 조직 자 

다음의 클라스들은 복잡한 응용프로그람 혹은 대화칸을 만드는데 쓰인다. 


QButtonGroup 

QButton 창문부품들을 한 그름으로 구성 한다. | 

QGroupBox 
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QHBox 

자식 창문부품들의 수평 기 하학적 관리 

QHButtonGroup 

하나의 수평행을 가전 그름으로 QButton 창문부품들을 
구성 한다. 

QHGroupBox 

하나의 수평 행을 가진 그름으로 창문부품들을 구성 한다. 

QSplitter 

분할창문부품을 실현한다. 

QTabWidget 

타브형 창문부품들의 탄창 

QVBox 

자식 창문부품들의 수직 기 하학적 관리 

QVButtonGroup 

수직 렬 안의 QButton 창문부품들을 조직 한다. 

QVGroupBox 

수직 렬 안의 창문부품그룹을 조직 한다. 

QWidgetStack 

제일 웃끝의 창문부품만 볼수 있는 창문부품탄창 

QWizard 

위자드대화칸용 틀거리 

QWorkspace 

MDI 용과 갈은 장식창문을 포함할수 있는 작업공간창문 


20) 플라그인 

다음의 클라스들은 공유서고(실례로 .so 와 DLL 파일들)과 Qt 풀라그인들을 론한다 . 


QGfxDriverPlugin 

Qt/Embedded 그라픽 스구동프로그람플라그인용 추상기 
초클라스 

QlmageFormatPlugin 

사용자정 의 화상형 식 플라그인 용 추상기 초클라스 

QKbdD riverP lugin 

Qt/Embedded 건반구동프로그람플라그인용 추상기 초콜 
라스 

QLibrary 

공유서고를 조종하기 위한 래퍼 

QMouseDriverPlugin 

Qt/Embedded 마우스구동프로그람플라그인 용 추상기 초 
클라스 

QSqlDriverPlugin 

사용자정 의 QSqlDriver 플라그인용 추상기 초클라스 

QStylePlugin 

사용자정 의 QStyle 플라그인용 추상기 초콜라스 

QT extCodecP 1 ugin 

사용자정 의 QTextCodec 플라그인 용 추상기 초들라스 

QWidgetP lugin 

사용자정 의 QWidget 플라그인 용 추상기 초들라스 


21) 대 화칸클라스 

다음의 클라스들은 더 간단한 창문부품 즉 일반적으로 대화칸으로 구성되는 복합창 
문부품이다._ 


QColorDialog 

색을 지정하기 위한 대화칸창문부품 

QDialog 

대화창문의 기초콜라스 

QErrorMessage 

오유통보현시대화칸 

QFileDialog 

사용자가 파일 이 나 등록부를 선택 하게 하는 대화칸 

QFontDialog 

서체를 선택하는 대화칸창문부품 

QInputDialog 

사용자로부터 단일값을 얻기 위한 단순하고 편리한 대 
화 칸 

QMessageBox 

간단한 통보문，그림기호, 몇개의 단추들을 가전 이행 
금지 대화칸 

QProgressDialo 

g 

느린 조작의 진척상황 제공 

QTabDialog 

타브형 창문부품들의 탄창 

QWizard 

위자드대화칸용틀거리 
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22) Qt 형 판서 고클라스 

Qt Template Library ( QTL ) 은 객체용기를 제공하는 형판들의 모임 이 다. 


QMap 

사전을 제공하는 값에 기초한 형판클라스 

QMapConstlterator 

QMap 의 상수반복자 

QMapIterator 

QMap 의 반복자 

QPair 

한쌍의 원소들을 제공하는 값기초형판클라스 

QValueList 

목록을 제공하는 값기초형판콜라스 

QValueListConstlterat 

or 

QValueList 의 상수반복자 

QValueListlterator 

QValueList 의 반복자 

QValueStack 

탄창을 제공하는 값기초형판클라스 

QValueVector 

동적배 럴을 제 공하는 값기 초형 판콜라스 


23) 본문관련클라스 

다음의 클라스들은 본문처 리와 관련된다. 


QChar 

간략유니코드문자 

QCharRef 

QString 용 방조클라스 

QConstString 

상수유니 코드자료를 사용하는 문자렬 객 체 

QC St ring 

전형 적 인 C 의 0으로 완료되 는 char 배 렬 (char *) 의 추상화 

QLabel 

본문 혹은 화상현시 

QLocale 

수들과 여 러 가지 언어 로 된 그것 들의 문자렬표현사이 의 변 
환 

QSimpleRichText 

현시할수 있는 자그마한 리치 본문부분 

QString 

유니코드본문과 전형적 인 C 의 ’\0’완료문자배럴의 추상화 

QStringList 

문자렴 목록 

QStrList 

char * 의 2중련결목록 

QStyleSheet 

리 치 본문묘사용의 형 식 들의 집 합과 타그생 성 기 

QStyleSheetltem 

일련의 본문형식들의 은폐 

QSyntaxHigh lighter 

QTextEdit 문법 강조표시 기 를 실 현 하는 기 초클라스 

QTextBrowser 

초본문항행 이 가능한 리치본문열 람기 

QTextEdit 

강력 한 단일페 지 리 치 본문편집 기 

QTextIStream 

입 력스트림용 편의들라스 

QTextOStream 

출력스트림용 편의클라스 

QTextStream 

QIODevice 를 사용하여 본문을 읽고 쓰는 기본함수들 


24) 스레 드화통보 

다음의 콜라스들은 스레드화된 응용프로그람들과 관련이 있다. 


QMutex 

스레 드들사이 의 호출계 렬 화 

QMutexLocker 

QMutexe 의 잠그기와 해제를 간단화한다. 

QSemaphore 

건전한 옹근쎄마휘 

QThread 

가동환경 에 의존하지 않는 스레드 

QThreadStorage 

스레드별 자료기억 


스레드들사이의 조건들에 대 한 대 기/동작 (wakin 




25) 창문부품모양과 형 식 

다음의 클라스들은 응용프로그람의 모양과 형식을 전용화하는데 쓰인다. 


QBoxLayout 

자식 창문부품들을 수평 혹은 수직 으로 배 치 한다. 

QButtonGroup 

그룹안의 QButton 창문부품들을 조직한다. 

QCDEStyle 

CDE 형식 

QColor 

RGB 혹은 HSV 값에 기초하는 색 

QColorGroup 

창문부품색의 그룹 

QCommonStyle 

GUI 의 일반적형식을 은폐한다. 

QCursor 

임의의 모양의 마우스지적자 

QFont 

본문그리기에 사용하는 서체 

QGLayoutlterator 

내 부배 치 관리 자반복자들의 추상기 초콜라스 

QGrid 

자식들의 단순한 기 하학적관리 

QGridLayout 

창문부품을 격자로 배 치한다. 

QGroupBox 

제목있는 그룹칸프레 임 

QHBox 

자식창문부품들의 수평기하학적관리 

QHBoxLayout 

창문부품들을 수평 으로 배 치 한다. 

QHButtonGroup 

하나의 수평행을 가진 그롭으로 QButton 창문부품들을 
구성 한다. 

QHGroupBox 

하나의 수평행을 가진 그름으로 창문부품들을 구성 한다. 

QLayout 

기 하학적 관리 기 들의 기 초콜라스 

QLayoutltem 

QLayout 가 조작하는 추상적 인 항목 

QLayoutlterator 

QLayoutltem 에 대한 반복자 

QMacStyle 

모 양관리 기 (Appearance Manager ) 형 식 을 실현 한다. 

QMotifPlusStyle 

복잡한 Motif 형식 

QMotifStyle 

Motif 형 식 

QPalette 

매 개 상태 를 위한 색그룹 

QPlatinumStyle 

Mac/Platinum 형 식 

QSGIStyle 

SGI/Irix 형 식 

QSizeGrip 

제 일웃준위창문용 구석 격 자 

QSizePolicy 

수평 및 수직크기조절방법을 서술하는 배 치관리자속성 

QSpacerltem 

배치관리자에서 빈 공간 

QStyle 

GUI 의 형식 

QStyleOption 

QStyle 함수용 선택 파라메 터 

QVBox 

자식창문부품들의 수직기하학적관리 

QVBoxLayout 

창문부품들을 수직 으로 배 치한다. 

QVButtonGroup 

수직 렬안의 QButton 창문부품들을 조직한다. 

QVGroupBox 

수직 렬안의 창문부품그롭을 조직 한다. 

QWidgetltem 

한 창문부품을 표시 하는 배 치 관리 자항목 

QWindowsStyle 

Microsoft Windows 형 식 


26) XML 

다음의 클라스들은 XML 사용자들과 관련이 있다. 


QDomAttr 

QDomElement 의 한개 속성 을 표시 한다. 

QDomCDATASection 

XML CDATA 절 을 표시한다. 
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QDomCharacterData 

DOM 안의 일 반문자렬 의 표시한다 . 

QDomComment 

XML 설명 문을 표시 한다 . 

QDomDocument 

XML 문서 를 표시한다 . 

QDomDocumentF ragment 

보통 완전한 QDomDocument 이 아닌 

QDomNode 들의 나무 

QDomDocumentT ype 

문서 나무에 서 DTD 의 표현 

QDomElement 

DOM 나무의 한 요소를 표시한다 . 

QDomEntity 

XML 실체 를 표시한다 . 

QDomEntity Reference 

XML 실 체참고를 표시한다 . 

QDomlmplementation 

DOM 실현의 특성 에 대 한 정 보 

QDomNamedNodeMap 

이 름에 의해 호출될 수 있는 마디 집 합 

QDomNode 

DOM 나무의 모든 마디 들의 기 초콜라스 

QDomNodeList 

QDomNode 객체들의 목록 

QDomNotation 

XML 표기 법 을 표시 한다 . 

QDomProcessinglnst ruction 

XML 처 리 지 령 을 표시한다 . 

QDomText 

문법 해석된 XML 문서의 본문자료를 표시한다 . 

QXmlAttributes 

XML 속성 

QXmlContentHandler 

XML 자료의 론리적내용을 알리기 위한 대면부 

QXmlDeclHandler 

XML 자료의 선언내 용을 알리 기 위 한 대 면부 

QXmlDefaultHandler 

모든 XML 처 리 함수콜라스들의 기 정 실 현 

QXmlDTDHandler 

XML 자료의 DTD 내 용을 알리 기 위 한 대 면부 

QXmlEntity Resolver 

XML 자료에 포함된 외 부실 체 를 해 결 하기 위 한 
대면부 

QXmlErrorHandler 

XML 자료로 오유를 알리 기 위한 대 면부 

QXmllnputSource 

QXml Reader 파생 클 라스용 입 력 자료 

QXmlLexicalHandler 

XML 자료의 어휘적내용을 알리 기 위한 대면부 

QXmlLocator 

파일안에서 문법해석위 치 에 대 한 정보를 가지는 

XML 처 리 함수 클라스 

QXmlNamespaceSupport 

이름공간유지를 포함하려고 하는 XML 읽기기구용 
방조콜라스 

QXmlParseException 

QXmlErrorHandler 대면부에서 오유통보에 
사용한다 . 

QXml Reader 

XML 읽기기구(문법 해석기)의 대면부 

QXmlSimpleReader 

간단한 XML 읽 기 기 구 (문법 해 석 기 )의 실 현 


27) 기 타 클라스 

다음의 콜라스들은 다른 범 주에 속하지 않는 쓸모있는 클라스들이다 . 


QAccel 

건반지름건과 지름건을 조종한다 . 

QAccessible 

호출가능성과 관련한 렬거형 및 정적함수들 

QAccessiblelnterface 

호출가능한 객체들에 대한 정보를 발생하는 대 
정의 한다 . 

QAccessibleObject 

QObject 용 QAccessiblelnterface 의 부분들 

QCustomMenuItem 

올리 펼 침 차림 표에 서 사용자정 의 차림 표항목들을 




QDoubleValidator 

류동소수점수의 범위검사 

QErrorMessage 

오유통보현시대화칸 

QFilelconProvider 

사용하려는 QFileDialog 용 그림기호 

QFileP review 

QFileDialog 에 서 파일미 리 보기 

QFocusData 

초점련쇄안의 창문부품목록을 관리 한다. 

QIntValidator 

문자렬 이 지정된 범위안의 유효옹근수를 포함한다는것을 
담보하는 유효성검사기 

QKeySequence 

지름건으로 사용되는 건들의 렬을 은폐한다. 

QMacMime 

열린표준형 MIME 를 Mac 형 식 으로 변환한다. 

QMenuData 

QMenuBar 와 QPopupMenu 의 기 초클라스 

QMimeSource 

일정한 MIME 형의 형식화된 자료를 제공하는 객체들의 
주상화 

QProcess 

외 부크로그람들을 기동하고 그것들과 교제 하는데 리용 

QRangeControl 

범위안의 옹근수값 

QRegExp 

정규식들을 사용한 패턴대조 

QRegExpValidator 

정규식에 대하여 문자렬을 검사하는데 리용 

QSettings 

가동환경 에 의 존하지 않는 영속적 인 응용프로그람환경 설정 

QSignal 

QObject 를 계 승하지 않는 클라스에 신호를 보낼 때 리 용 

QSplashScreen 

응용프로그람을 기동할 때 보여주는 스플라쉬화면 

Qt 

대역 이여야 하는 여 러가지 식별자들을 위한 이름공간 

QUrl 

URL 문법해석 기 와 그의 간단한 동작 

QUrllnfo 

URL 에 대 한 정 보를 보관한다. 

QUrlOperator 

일 반적 인 URL 조작 

QValidator 

입력본문의 확증 

QVariant 

가장 일 반적 인 Qt 자료형 들을 위 한 공용체 와 같이 
동작한다. 

QWindowsMime 

공개 표준 MIME 를 Window 오려 둠판형 식 으로 변환한다. 


3. 집합클라스 

집합콜라스는 많은 항목들을 자료구조에 보관하는 용기로서 항목의 삽입과 삭제， 
검색과 갈은 집합의 내용에 대한 여러가지 조작을 제공한다. 

Qt 에는 여 러개의 값기초집 합들라스들과 지적자기초집 합클라스들이 있다. 지적 자기 
초집 합클라스는 항목에 로의 지 적 자들과 작업 하며 값기 초클라스들은 그 항목들의 사본들을 
복사한다. 값기초집합은 STL 용기들라스들과 비슷하며 STL 알고리듬 및 용기들과 함께 
쓰일수도 있다. 

값에 기초한 집 합은 다음과 갈다. 

QValueList , 값기초목록. 

QValueVector , 값기초백토르. 

QValueStack , 값기초탄창. 

QMap , 값기 초사전 (련상배 렬 ). 

지적자에 기초한 집합은 다음과 같다. 

QCache 와 QIntCache , 적어도 최근에 사용된 ( LRU , least recently used ) 캐쉬. 
QDict , QIntDict 그리고 QPtrDict 사전. 

QPtrList , 2중련결목록. 

QPtrQueue , 처음 넣은것을 처음에 꺼내는 ( FIFO , first in , first out ) 대기렬. 
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QPtrStack, 마지막으로 넣은것을 처음에 꺼내는 (LIFO, last in, first out) 탄창 . 

QPtrVector, 벡토르 . 

QMemArray 는 례외로서 지적자나 값에 기초하지 않고 기억기기초이다 . 단순자료 
형을 리용할 때의 최대효과성은 보통 배렬에 사용되며 배렬원소들의 복사와 비교에 비트 
연산을 리용한다 . 

이 클라스들중 일부는 대응하는 반복자를 가지고있다 . 반복자는 집합안의 항목들을 
항행 하기 위 한 클라스이 다 . 

QCachelterator 와 QIntCachelterator 

QDictlterator 와 QIntDictIterator, QPtrDictlterator 

QPtrListlterator 

QValueListlterator 와 QValueListConstlterator 

QMapIterator 와 QMapConstlterator 

값기 초집 합과 그것 에 대 하여 조작하는 알고리 듬은 Qt 형 판서 고에 서 분류하였 다 . 

1) 지 적 자기 초용기 의 구성 방식 

지 적 자기 초용기 를 위 한 내부기초클라스가 4 개 (QGCache 와 QGDict, QGList, 
QGVector) 있으며 그것들은 void 지적자에 대하여 조작한다 . 빈약한 형판층은 항목들 
과 void 지적자들사이의 강제변환에 의하여 실제의 집합을 실현한다 . 

이 전 략은 Qt 형 판들의 성 능을 떨 구지 않고 공간에 대 하여 아주 효과적이 도록 한다 . 
(즉 이 형판들중 하나의 실례를 만들 때 기초클라스에로의 inline 호출만 추가한다 .) 

2) QPtrList 실 례 

이 실례는 목록에 Employee 항목들을 보관하고 그것들을 반대순서로 출력하는 방 
법을 보여준다 . 

#include <qptrlist. h> 

#include <qstring. h> 

#include <stdio.h> 


class Employee 

{ 

public ： 

Employee( const char *name, int salary ) { n=name ； s=salary ； } 
const char *name() const { return n ； } 
int salary () const { return s; } 
private ： 

QString n ； 
int s ； 


int main () 

{ 

QPtrLisKEmployee 〉 list ； // list of pointers to Employee 

list. setAutoDelete( TRUE ) ； // delete items when they are removed 

list, append ( new Employee (’’Bill”, 50000) ) ； 
list, append( new Employee(’’Steve", 80000) ) ； 
list, append ( new Employee (’’Ron", 60000) ) ； 


305 



QPtrListIterator < Employee > it ( list ) : // iterator for employee list 
for ( it . toLastO ; it . current 0; — it ) ) { 

Employee *emp = it . current () : 

printf ( "%s earns % d \ n ", emp -> name (), emp -> salary () ■); 


return 0； 

} 

프로그람출력 : 

Ron earns 60000 
Steve earns 80000 
Bill earns 50000 

3) 집 합항목들의 관리 

모든 지적자기초집합은 QPtrCollection 기초콜라스를 계승한다. 이 들라스는 집합 
안의 항목수와 삭제전략에 대해서만 알고있다. 

기정으로 집합안의 항목들은 집합에서 삭제될 때 삭제되지 않는다. 
0아1乂：0116(：仕011::3태쇼새；0예하6()함수는 삭제전략을 지정한다. 이 실례에서는 자동삭 
제를 허용하여 항목들이 목록에서 삭제될 때 항목자체를 삭제하게 한다. 

집합에 항목을 삽입할 때 지적자만 복사되고 항목자체는 복사되지 않는다. 이것을 
얕은 복사 (shallow copy ) 라고 한다. 항목이 삽입될 때 집합에 항목자료모두를 복사하 
게 할수 있다. (이것을 깊은 복사 (deep copy ) 라고 한다.) 항목을 삽입하는 집합함수들 
은 삽입 하려는 항목에 대 하여 가상함수 QPtrCollection : : newltem () 를 호출한다. 자 
기의 집합에서 깊은 복사를 유지하려고 한다면 집합을 계승하여 그것을 재정의한다. 

목록으로부터 항목을 삭제 할 때 가상함수 QPtrCollection : : deleteltem () 가 호출 
된다. 모든 집 합클라스들의 기정 실현에서는 자동삭제 가 허 용되 여있으면 항목이 삭제된다. 

4) 사용법 

QPtrList < type > 와 같은 지 적 자기 초들라스는 次 pe 객 체 의 지 적 자집 합을 정 의한다. 
지 적 자 (*) 는 무조건적이 다. 

여기서는 QPtrList 를 론하지만 같은 수법을 모든 지적자기초집합클라스들과 모든 
집 합클라스반복자들에 적 용한다. 

형판실례의 창조: 

QPtrList < Employee > list ； // 목록사용 

실례에서 항목의 클라스 혹은 형 Employee 는 목록정의에 앞서 정의되여야 한다. 

// Employee 가 정의되지 않았으므로 작업하지 않는다. 
class Employee； 

QPtrList<Employee> list； 

// Employee 가 리용되기전에 정의되므로 다음 코드는 작업한다. 
class Employee { 


QPtrList < Employee > list ； 

5) 반복자 

QPtrList 는 목록을 항행하는 성원함수들을 가지지만 흔히 반복자를 사용하는것이 
더 좋다. QPtrListlterator 는 아주 안전하고 동시에 수정되고있는 목록들을 항행할수 
있다. 여 러 반복자들이 같은 집합에서 록립적으로 작업할수 있다. 
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QPtrList 은 현재 거기에 조작하는 모든 반복자들의 내부목록을 가지고있다 . 목록 
항목이 삭제될 때 목록은 그에 따라 모든 반복자들을 갱신한다 . 

QDict 와 QCache 집합에 는 항행함수가 없다 . 이 집합을 항행 하려면 QDictlterator 
혹은 QCachelterator 를 사용해 야 한다 . 

6) 미리 정의된 집합 

어의 미리 정의된 집합콜라스는 다음과 같다 . 

• 문자렬 목록 : QStrList 과 QStrIList (qstrlist. h) , QStringList 

(qstringlist.h) 

• 문자렬벡 토르 : QStrVec 와 QStrIVec (qstrvec.h); 이것들은 낡은것 이 다 . 
대부분의 경우에 절대공유된 QString 유니코드문자렬의 값목록인 QStringList 를 

선택 할수 있 다 . QPtrStrList 과 QPtrStrIList 는 문자렬 자체가 아니 라 char 지적자만 보 
관한다 . 

7) 지 적 자기 초집 합클라스와 관련 한 반복자클라스들의 목록 _ 


QAsciiCache 

char* 건에 기초한 캐쉬를 제공하는 형판클라스 

QAsciiCachelterator 

QAsciiCache 집 합용 반복자 

QAsciiDict 

char* 건에 기초한 사전을 제공하는 형판콜라스 

QAsciiDictlterator 

QAsciiDict 집 합용 반복자 

QBitArray 

비 트배 렬 

QBitVal 

QBitArray 와 함께 쓰이 는 내 부클라스 

QBuffer 

QByteArray 에 서 조작하는 I/O 장치 

QByteArray 

바이트배럴 

QCache 

QString 건에 기 초한 캐 쉬 를 제 공하는 형 판콜라스 

QCachelterator 

QCache 집 합용 반복자 

QCString 

C 의 령 마감 char 배 렬 (char *) 의 추상화 

QDict 

QString 건에 기 초한 사전을 제 공하는 형 판콜라스 

QDictlterator 

QDict 집 합의 반복자 

QIntCache 

긴 열쇠에 기 초하는 캐 쉬를 제 공하는 형 판콜라스 

QIntCachelterator 

QIntCache 집 합의 반복자 

QIntDict 

긴열쇠에 기초하는 등록부를 제공하는 형판들라스 

QIntDictIterator 

Qlnffiict 집 합의 반복자 

QObjectList 

QObject 들의 QPtrList 

QObjectListlterator 

QObjectList 용 반복자 

QPtrCol lection 

대 다수 지 적 자에 기 초한 Qt 집 합의 기 초들라스 

QPtrDict 

void* 건에 기초하는 사전을 제공하는 형판콜라스 

QPtrDictlterator 

QPtrDict 집 합용 반복자 

QPtrList 

목록을 제공하는 형판들라스 

QPtrListlterator 

QPtrList 집 합용 반복자 

QPtrQueue 

대기 렬을 제 공하는 형 판콜라스 

QStrIList 

대소문자식별비교기능을 가진 char* 의 

2 중련결목록 

QStrList 

char* 의 2 중련결목록 
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부록 2. 수 2-9999 의 씨수표 


2 

3 

5 

7 

11 

13 

17 

19 

23 

29 

31 

37 

41 

43 

47 

53 

59 

61 

67 

71 

73 

79 

83 

89 

97 

101 

103 

107 

109 

113 

127 

131 

137 

139 

149 

151 

157 

163 

167 

173 

179 

181 

191 

193 

197 

199 

211 

223 

227 

229 

233 

239 

241 

251 

257 

263 

269 

271 

277 

281 

283 

293 

307 

311 

313 

317 

331 

337 

347 

349 

353 

359 

367 

373 

379 

383 

389 

397 

401 

409 

419 

421 

431 

433 

439 

443 

449 

457 

461 

463 

467 

479 

487 

491 

499 

503 

509 

521 

523 

541 

547 

557 

563 

569 

571 

577 

587 

593 

599 

601 

607 

613 

617 

619 

631 

641 

643 

647 

653 

659 

661 

673 

677 

683 

691 

701 

709 

719 

727 

733 

739 

743 

751 

757 

761 

769 

773 

787 

797 

809 

811 

821 

823 

827 

829 

839 

853 

857 

859 

863 

877 

881 

883 

887 

907 

911 

919 

929 

937 

941 

947 

953 

967 

971 

977 

983 

991 

997 

1009 

1013 

1019 

1021 

1031 

1033 

1039 

1049 

1051 

1061 

1063 

1069 

1087 

1091 

1093 

1097 

1103 

1109 

1117 

1123 

1129 

1151 

1153 

1163 

1171 

1181 

1187 

1193 

1201 

1213 

1217 

1223 

1229 

1231 

1237 

1249 

1259 

1277 

1279 

1283 

1289 

1291 

1297 

1301 

1303 

1307 

1319 

1321 

1327 

1361 

1367 

1373 

1381 

1399 

1409 

1423 

1427 

1429 

1433 

1439 

1447 

1451 

1453 

1459 

1471 

1481 

1483 

1487 

1489 

1493 

1499 

1511 

1523 

1531 

1543 

1549 

1553 

1559 

1567 

1571 

1579 

1583 

1597 

1601 

1607 

1609 

1613 

1619 

1621 

1627 

1637 

1657 

1663 

1667 

1669 

1693 

1697 

1699 

1709 

1721 

1723 

1733 

1741 

1747 

1753 

1759 

1777 

1783 

1787 

1789 

1801 

1811 

1823 

1831 

1847 

1861 

1867 

1871 

1873 

1877 

1879 

1889 

1901 

1907 

1913 

1931 

1933 

1949 

1951 

1973 

1979 

1987 

1993 

1997 

1999 2003 

2011 

2017 2027 2029 2039 2053 

2063 

2069 2081 

2083 

2087 2089 2099 2111 

2113 

2129 

2131 

2137 2141 

2143 

2153 2161 

2179 2203 

2207 2213 

2221 

2237 2239 2243 

2251 

2267 2269 2273 

2281 

2287 

2293 

2297 2309 

2311 

2333 

2339 

2341 

2347 

2351 

2357 

2371 

2377 2381 

2383 

2389 2393 

2399 2411 

2417 2423 

2437 2441 

2447 

2459 2467 2473 

2477 2503 

2521 

2531 

2539 2543 2549 2551 

2557 2579 2591 

2593 

2609 2617 

2621 

2633 2647 2657 2659 2663 

2671 

2677 2683 

2687 

2689 2693 

2699 

2707 2711 

2713 

2719 2729 

2731 

2741 

2749 2753 

2767 

2777 2789 2791 

2797 2801 

2803 

2819 

2833 

2837 2843 

2851 

2857 2861 

2879 2887 

2897 2903 

2909 2917 2927 

2939 2953 

2957 

2963 

2969 

2971 

2999 

3001 

3011 

3019 

3023 

3037 3041 

3049 3061 

3067 3079 

3083 

3089 3109 

3119 3121 

3137 

3163 

3167 

3169 3181 

3187 3191 

3203 

3209 3217 3221 

3229 3251 

3253 

3257 

3259 3271 

3299 

3301 

3307 3313 

3319 3323 

3329 3331 

3343 

3347 3359 

3361 

3371 

3373 

3389 3391 

3407 3413 

3433 

3449 3457 

3461 

3463 

3467 

3469 3491 

3499 3511 
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3517 3527 3529 3533 3539 3541 3547 3557 3559 3571 
3581 3583 3593 3607 3613 3617 3623 3631 3637 3643 
3659 3671 3673 3677 3691 3697 3701 3709 3719 3727 
3733 3739 3761 3767 3769 3779 3793 3797 3803 3821 
3823 3833 3847 3851 3853 3863 3877 3881 3889 3907 
3911 3917 3919 3923 3929 3931 3943 3947 3967 3989 
4001 4003 4007 4013 4019 4021 4027 4049 4051 4057 
4073 4079 4091 4093 4099 4111 4127 4129 4133 4139 
4153 4157 4159 4177 4201 4211 4217 4219 4229 4231 
4241 4243 4253 4259 4261 4271 4273 4283 4289 4297 
4327 4337 4339 4349 4357 4363 4373 4391 4397 4409 
4421 4423 4441 4447 4451 4457 4463 4481 4483 4493 
4507 4513 4517 4519 4523 4547 4549 4561 4567 4583 
4591 4597 4603 4621 4637 4639 4643 4649 4651 4657 
4663 4673 4679 4691 4703 4721 4723 4729 4733 4751 
4759 4783 4787 4789 4793 4799 4801 4813 4817 4831 
4861 4871 4877 4889 4903 4909 4919 4931 4933 4937 
4943 4951 4957 4967 4969 4973 4987 4993 4999 5003 
5009 5011 5021 5023 5039 5051 5059 5077 5081 5087 
5099 5101 5107 5113 5119 5147 5153 5167 5171 5179 
5189 5197 5209 5227 5231 5233 5237 5261 5273 5279 
5281 5297 5303 5309 5323 5333 5347 5351 5381 5387 
5393 5399 5407 5413 5417 5419 5431 5437 5441 5443 
5449 5471 5477 5479 5483 5501 5503 5507 5519 5521 
5527 5531 5557 5563 5569 5573 5581 5591 5623 5639 
5641 5647 5651 5653 5657 5659 5669 5683 5689 5693 
5701 5711 5717 5737 5741 5743 5749 5779 5783 5791 
5801 5807 5813 5821 5827 5839 5843 5849 5851 5857 
5861 5867 5869 5879 5881 5897 5903 5923 5927 5939 
5953 5981 5987 6007 6011 6029 6037 6043 6047 6053 
6067 6073 6079 6089 6091 6101 6113 6121 6131 6133 
6143 6151 6163 6173 6197 6199 6203 6211 6217 6221 
6229 6247 6257 6263 6269 6271 6277 6287 6299 6301 
6311 6317 6323 6329 6337 6343 6353 6359 6361 6367 
6373 6379 6389 6397 6421 6427 6449 6451 6469 6473 
6481 6491 6521 6529 6547 6551 6553 6563 6569 6571 
6577 6581 6599 6607 6619 6637 6653 6659 6661 6673 
6679 6689 6691 6701 6703 6709 6719 6733 6737 6761 
6763 6779 6781 6791 6793 6803 6823 6827 6829 6833 
6841 6857 6863 6869 6871 6883 6899 6907 6911 6917 
6947 6949 6959 6961 6967 6971 6977 6983 6991 6997 
7001 7013 7019 7027 7039 7043 7057 7069 7079 7103 
7109 7121 7127 7129 7151 7159 7177 7187 7193 7207 
7211 7213 7219 7229 7237 7243 7247 7253 7283 7297 
7307 7309 7321 7331 7333 7349 7351 7369 7393 7411 
7417 7433 7451 7457 7459 7477 7481 7487 7489 7499 
7507 7517 7523 7529 7537 7541 7547 7549 7559 7561 
7573 7577 7583 7589 7591 7603 7607 7621 7639 7643 
7649 7669 7673 7681 7687 7691 7699 7703 7717 7723 
7727 7741 7753 7757 7759 7789 7793 7817 7823 7829 
7841 7853 7867 7873 7877 7879 7883 7901 7907 7919 
7927 7933 7937 7949 7951 7963 7993 8009 8011 8017 
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8039 8053 8059 8069 8081 8087 8089 8093 8101 8111 

8117 8123 8147 8161 8167 8171 8179 8191 8209 8219 

8221 8231 8233 8237 8243 8263 8269 8273 8287 8291 

8293 8297 8311 8317 8329 8353 8363 8369 8377 8387 

8389 8419 8423 8429 8431 8443 8447 8461 8467 8501 

8513 8521 8527 8537 8539 8543 8563 8573 8581 8597 

8599 8609 8623 8627 8629 8641 8647 8663 8669 8677 

8681 8689 8693 8699 8707 8713 8719 8731 8737 8741 

8747 8753 8761 8779 8783 8803 8807 8819 8821 8831 

8837 8839 8849 8861 8863 8867 8887 8893 8923 8929 

8933 8941 8951 8963 8969 8971 8999 9001 9007 9011 

9013 9029 9041 9043 9049 9059 9067 9091 9103 9109 

9127 9133 9137 9151 9157 9161 9173 9181 9187 9199 

9203 9209 9221 9227 9239 9241 9257 9277 9281 9283 

9293 9311 9319 9323 9337 9341 9343 9349 9371 9377 

9391 9397 9403 9413 9419 9421 9431 9433 9437 9439 

9461 9463 9467 9473 9479 9491 9497 9511 9521 9533 

9539 9547 9551 9587 9601 9613 9619 9623 9629 9631 

9643 9649 9661 9677 9679 9689 9697 9719 9721 9733 

9739 9743 9749 9767 9769 9781 9787 9791 9803 9811 

9817 9829 9833 9839 9851 9857 9859 9871 9883 9887 

9901 9907 9923 9929 9931 9941 9949 9967 9973 
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이 책은 콤퓨터를 전공으로 하는 교원，연구사 , 대학생들을 위한 참고서이다 . 
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